atendroZAP Documentação
DocsChamadas de voz
Markdown
POST/call/make

Iniciar ligação por instância calls

Exige kind=calls conectado e módulo ligado. Retorna 201 ao iniciar; acompanhar o estado. Em instância whatsapp mantém 501 calls_not_supported. Não equivale à chamada sem áudio do provedor legado.

Autenticação

Header obrigatório: token. Use o token da instância.

Base URL: a API do servidor selecionado, como https://1.atendro.cloud. O domínio wpp.atendro.cloud hospeda a documentação e o console.

Idempotência: suporta Idempotency-Key, com retenção de 24 horas. Preserve a mesma chave, método, caminho e bytes do corpo ao repetir. Entenda a idempotência.

Headers adicionais

CampoTipoPresençaDescrição
X-Request-IdstringopcionalASCII visível sem espaços, 1–128 caracteres. Inválido/ausente é substituído por UUID. Ecoado na resposta. Comprimento máximo: 128
Idempotency-KeystringopcionalASCII visível sem espaços, 1–128. Repetir método, caminho e os mesmos bytes do JSON. 409 em andamento; 422 se mudar a requisição. 504 é guardado e não deve causar reenvio automático. Comprimento mínimo: 1. Comprimento máximo: 128

Corpo da requisição

Formato: application/json. Corpo obrigatório.

CampoTipoPresençaDescrição
numberstringobrigatórioTelefone com DDI (formatação removida pela API) ou JID de conversa direta. Resolve as duas formas do nono dígito brasileiro. Comprimento mínimo: 1

Respostas

Chamada iniciada; acompanhar pelo callId.

CampoTipoPresençaDescrição
callIdstringobrigatório—
directionstringobrigatórioValores: "inbound", "outbound"
numberstringobrigatórioIdentidade telefônica canônica, quando conhecida.
jidstringopcional—
statusstringobrigatórioValores: "ringing", "connecting", "active", "ended"
startedAtstringobrigatórioFormato: date-time
answeredAtstringopcionalFormato: date-time
endedAtstringopcionalFormato: date-time
endReasonstringopcionalhangup, rejected, ring_timeout, closed ou motivo do motor.
endedBystringopcionalValores: "local", "remote"