Chamadas
Iniciar chamada de voz
/call/makeEsta função tem limite de uso próprio (429 ao passar).
Autenticação: envie a chave da conexão no header token ou em Authorization: Bearer.
Inicia uma chamada de voz para um contato específico. Este endpoint permite:
- Iniciar chamadas de voz para contatos
- Funciona apenas com números válidos do WhatsApp
- O contato receberá uma chamada de voz
Nota: O telefone do contato tocará normalmente, mas ao contato atender, ele não ouvirá nada, e você também não ouvirá nada. Este endpoint apenas inicia a chamada, não estabelece uma comunicação de voz real.
Opcional: Use call_duration para definir por quantos segundos a chamada deve tocar. Após esse período a chamada é encerrada automaticamente, sem precisar chamar /call/reject.
Exemplo de requisição:
{
"number": "5511999999999",
"call_duration": 15
}Exemplo de resposta:
{
"response": "Call successful"
}Erros comuns:
- 401: Token inválido ou expirado
- 400: Número inválido ou ausente
- 500: Erro ao iniciar chamada
Corpo da requisição (JSON)
| Campo | Tipo | Descrição |
|---|---|---|
| number* | string | Número do contato no formato internacional (ex: 5511999999999) Exemplo: 5511999999999 |
| call_duration | integer | Duração da chamada em segundos (opcional). Após esse tempo a chamada é encerrada automaticamente. Exemplo: 15 |
* obrigatório
Respostas
- 200Chamada iniciada com sucesso
- 400Requisição inválida
- 401Token inválido ou expirado
- 500Erro interno do servidor
Experimente
Atenção: a chamada é real. Ela roda na sua conexão e pode enviar mensagem de verdade. A chave fica só nesta tela e some ao sair dela; nunca é guardada.