Criar ou atualizar a integração de Voz IA

POST

/api/v3/integrations/voice-ai/elevenlabs

Cadastra a integração de voz IA (provedor de voz) do tenant. É um upsert: chamar de novo atualiza só os campos enviados (responde 200); a primeira chamada cria (201). Um webhook_secret omitido não é apagado.

Ativação (sem deploy, por tenant)

POST /api/v3/integrations/voice-ai/elevenlabs com elevenlabs_api_key e agent_ids (sem o webhook_secret ainda).

No provedor de voz: criar o webhook pós-chamada apontando para https://api-<tenant>.atendimento.khal.ai/api/v3/integrations/voice-ai/elevenlabs/post-call, evento Transcript, sem áudio, autenticação HMAC. Copiar o secret gerado.

PATCH com o webhook_secret.

No agente: ativar o override do webhook pós-chamada e fazer a tool que cria o ticket (POST /api/v2/ticket) gravar o UUID retornado na dynamic variable dk_ticket_id (via assignments).

Disponível a partir de 30/09/2026.

Requisição

Parâmetros Header

Parâmetros Bodyapplication/jsonObrigatório

Examples

Respostas

🟢200OK

application/json

Integração já existia e foi atualizada.

Bodyapplication/json

🟢201Criado

🟠400Requisição Inválida

🟠401Não Autorizado

🟠403Proibido

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/v3/integrations/voice-ai/elevenlabs' \
--header 'api-key: {{api-key}}' \
--header 'Content-Type: application/json' \
--data '{
    "elevenlabs_api_key": "sk_0123456789abcdef",
    "agent_ids": [
        "agent_9101m3s5y0d1eh79z0cayqtpx8b0"
    ],
    "attach_recording": true,
    "create_summary_note": true
}'

Response Example

200 - Exemplo de Sucesso

{
    "ok": true,
    "provider": "elevenlabs",
    "elevenlabs_api_key": "sk_…4b3a",
    "has_webhook_secret": true,
    "agent_ids": [
        "agent_9101m3s5y0d1eh79z0cayqtpx8b0"
    ],
    "attach_recording": true,
    "create_summary_note": true,
    "ticket_variable": "dk_ticket_id",
    "is_active": true
}

Modificado em 2026-11-04 03:05:55

Página anterior

Reprocessar TODAS as entregas com falha

Próxima página

Consultar a integração de Voz IA

Criar ou atualizar a integração de Voz IA

Ativação (sem deploy, por tenant)#

Requisição

Respostas

Ativação (sem deploy, por tenant)