Introdução
A API do WiseParts liga sistemas externos à sua conta através de HTTP. Um único token de integração autentica todos os pedidos, o URL base e as convenções indicados abaixo aplicam-se a tudo, e cada área do produto expõe os seus próprios endpoints.
Voz é a área disponível hoje. Envia os eventos de chamada à medida que acontecem — a tocar, atendida, concluída — e o WiseParts transforma-os em chamadas. Cada chamada alimenta depois três coisas: a barra de notificação no ecrã, o registo de atividade criado automaticamente e os valores nos Relatórios de Chamadas. Consulte Call Center para saber o que o produto faz com elas.
/pt, /es, /fr e /it e na versão inglesa.URL base
https://app.wiseparts.ai/api/v1
A versão é um segmento do caminho, não um cabeçalho nem um parâmetro do URL. Todos os caminhos da referência são relativos a essa base, seja qual for a área a que pertencem, e produção é o único servidor.
Operações de Voz
Post a call event — POST /voice/call. Cria uma chamada ou faz avançar uma que já existe. Envie um pedido por cada mudança de estado, reutilizando o mesmo id durante toda a chamada.
Look up a caller's priority — GET /voice/priority. Dado um número, devolve a prioridade do segmento a que pertence o cliente correspondente, para que o seu plano de encaminhamento possa colocar em fila os clientes conhecidos antes de a chamada ser oferecida.
List request history — GET /voice. Devolve o que o WiseParts registou na sua conta: o payload tal como foi recebido, a resposta, o estado e a duração.
As duas primeiras respondem também no outro verbo — /voice/call aceita GET com os mesmos campos na query string e /voice/priority aceita POST — para centrais telefónicas que apenas conseguem invocar um URL.
O seu primeiro pedido
Os passos abaixo usam os endpoints de Voz, mas o token e as convenções são os mesmos qualquer que seja a área que venha a invocar.
1. Obtenha o token. Em Integrações, abra a integração que está a ligar e copie o respetivo token. Identifica a conta e a integração, pelo que não existe um identificador de conta separado. Consulte Autenticação para saber como o enviar.
2. Envie um evento.
curl -X POST https://app.wiseparts.ai/api/v1/voice/call \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"id": "CALL-2026-08-12-0042",
"direction": "inbound",
"status": "answered",
"from": "+351210000000",
"caller_id": "201"
}'
id, direction e status são obrigatórios, e from é obrigatório quando a direção é inbound. A resposta é uma cadeia result de 48 caracteres aleatórios que não identifica nada — a referência a guardar é o seu próprio id.
3. Encontre-o no histórico.
curl "https://app.wiseparts.ai/api/v1/voice?search=request&search_term=CALL-2026-08-12-0042&sort=-created_at&limit=10" \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Accept: application/json"
search e search_term só funcionam em conjunto e não existe ordenação predefinida, por isso indique sort quando a ordem for importante. Envie também Accept: application/json: sem esse cabeçalho, um pedido que falhe a autenticação responde com um 302 para uma página de navegador em vez de um 401.
limit está definido, o corpo é um objeto com data, links e meta. Se retirar limit, recebe antes um array simples com todo o histórico — os dois formatos não são intermutáveis.Um 200 no passo 2 confirma a receção, não que uma chamada foi criada: uma chamada só avança, e um evento que chegue fora de ordem é aceite e descartado. Post a call event enumera os estados e quais deles podem sobrepor-se a quais.
Se a chamada nunca aparecer, Resolução de Problemas explica onde procurar — a começar pelo facto de um pedido que falhe a autenticação não deixar qualquer registo.