Os erros usam um único formato:
{
"error": {
"type": "invalid_request_error",
"code": "invalid_agent_field",
"message": "status must be draft or published",
"param": "status"
}
}
| Status | Significado |
|---|---|
| 400 | Entrada inválida (code e param dizem qual) |
| 401 | Chave de API ausente ou inválida |
| 402 | Créditos insuficientes para iniciar a chamada |
| 403 | A chave é somente leitura, ou o agente está indisponível |
| 404 | Não existe esse agente, chamada ou campanha neste workspace |
| 409 | Estado incorreto (p. ex. iniciar uma campanha em andamento), uma conta de provedor não está conectada, ou o número está na lista de não ligar (do_not_call) |
| 429 | Requisições demais; reduza o ritmo e tente de novo |
As requisições à API de voz do workspace nos últimos 30 dias (hora, endpoint, status, duração, chave e código de erro; sem corpos) são listadas em Chaves de API → Registro de requisições da API.
As leituras são limitadas a 120 requisições por minuto por chave; as escritas e as chamadas, a 30.
As chamadas são cobradas por minuto dos créditos do workspace, o mesmo saldo que o painel usa. As tarifas atuais estão na página de preços.