Webhook Pós-Chamada

{
  "id": 12345,
  "customer_phone": "+1234567890",
  "assistant_phone": "+1987654321",
  "duration": 125,
  "status": "completed",
  "extracted_variables": {
    "status": true,
    "summary": "Customer interested in product demo",
    "lead_quality": "high",
    "next_action": "schedule_demo"
  },
  "input_variables": {
    "customer_name": "John Doe",
    "product_interest": "Pro Plan"
  },
  "transcript": [
    {
      "text": "Hello! This is Sarah from Sua SofIA. How are you today?",
      "type": "transcript",
      "sender": "bot",
      "timestamp": 1756812511.315143
    },
    {
      "text": "Hi, I'm doing well, thanks for calling.",
      "type": "transcript",
      "sender": "human",
      "timestamp": 1756812514.104436
    },
    {
      "text": "I'm calling to tell you about our new product features.",
      "type": "transcript",
      "sender": "bot",
      "timestamp": 1756812522.918859
    },
    {
      "text": "That sounds interesting, tell me more.",
      "type": "transcript",
      "sender": "human",
      "timestamp": 1756812525.234567
    }
  ],
  "formatted_transcript": "AI: Hello! This is Sarah from Sua SofIA. How are you today?\nCustomer: Hi, I'm doing well, thanks for calling.\nAI: I'm calling to tell you about our new product features.\nCustomer: That sounds interesting, tell me more.",
  "recording_url": "https://suasofia.online/storage/recordings/call-12345.mp4",
  "created_at": "2025-01-15T10:30:00.000000Z",
  "finished_at": "2025-01-15T10:32:05.000000Z",
  "transfers": [
    {
      "id": 12346,
      "status": "completed",
      "transfer_to": "+1555123456",
      "duration": 85,
      "carrier_cost": 0.0156,
      "transcript": null,
      "formatted_transcript": "",
      "created_at": "2025-01-15T10:31:00.000000Z",
      "finished_at": "2025-01-15T10:32:25.000000Z"
    }
  ],
  "lead": {
    "id": 789,
    "phone_number": "+1234567890",
    "variables": {
      "source": "website",
      "interest_level": "high"
    },
    "status": "contacted",
    "call_tries": 2,
    "created_at": "2025-01-15T09:00:00.000000Z",
    "updated_at": "2025-01-15T10:32:05.000000Z",
    "campaign": {
      "id": 456,
      "name": "Product Demo Campaign",
      "status": "active",
      "allowed_hours_start_time": "09:00",
      "allowed_hours_end_time": "17:00",
      "allowed_days": ["monday", "tuesday", "wednesday", "thursday", "friday"],
      "max_calls_in_parallel": 5,
      "max_retries": 3,
      "retry_interval": 60,
      "created_at": "2025-01-15T08:00:00.000000Z",
      "updated_at": "2025-01-15T08:00:00.000000Z"
    }
  }
}

O Webhook Pós-Chamada é enviado automaticamente para a URL de webhook especificada após cada chamada ser concluída. Este webhook contém detalhes da chamada, variáveis extraídas, transcrição e, opcionalmente, a URL da gravação.

Configuração do Webhook

Para habilitar webhooks pós-chamada:

Configure a URL do webhook do seu assistente nas configurações do assistente
Habilite “Post call webhook” na configuração do assistente
Defina variáveis pós-chamada que a IA deve extrair

Formato da Requisição

O webhook é enviado como uma requisição POST para a URL configurada com o seguinte payload JSON:

Estrutura do Payload

integer

Identificador único da chamada

string

Número de telefone do cliente em formato E.164 (ex: “+1234567890”) ou null se não disponível

string

Número de telefone usado pelo assistente em formato E.164 ou null se não disponível

integer

Duração da chamada em segundos

string

Status final da chamada (ex: “completed”, “busy”, “failed”)

object

Variáveis extraídas pela IA com base na configuração do seu schema pós-chamada

Show Exemplo de variáveis extraídas

boolean

Se o objetivo da chamada foi alcançado

string

Resumo da chamada em poucas palavras

string|number|boolean

Quaisquer variáveis personalizadas que você definiu na configuração do assistente

object

Variáveis que foram passadas para o assistente antes da chamada começar

string

Transcrição completa da conversa

string

URL para baixar a gravação da chamada (incluída apenas se “Include recording in webhook” estiver habilitado nas configurações do assistente)

string

Timestamp ISO 8601 de quando a chamada foi iniciada

string

Timestamp ISO 8601 de quando a chamada foi concluída (usa updated_at do registro da chamada)

object

Informações do lead (incluído apenas para chamadas de campanha)

Show Propriedades do lead

integer

Identificador único do lead

string

Número de telefone do lead

object

Variáveis associadas ao lead

string

Status atual do lead

integer

O número de tentativas de chamada feitas para este lead

string

Quando o lead foi criado

string

Quando o lead foi atualizado pela última vez

object

Informações da campanha (se disponível)

Show Propriedades da campanha

integer

ID da campanha

string

Nome da campanha

string

Status da campanha

string

Horário de início permitido da campanha

string

Horário de término permitido da campanha

array

Dias permitidos da campanha

integer

Máximo de chamadas simultâneas para a campanha

integer

Máximo de tentativas de retentativa para leads

integer

Intervalo de retentativa em minutos

string

Quando a campanha foi criada

string

Quando a campanha foi atualizada pela última vez

array

Lista de chamadas de transferência feitas durante esta chamada (incluído apenas se a chamada tiver transferências)

Show Propriedades da transferência

integer

Identificador único da chamada de transferência

string

Status final da chamada de transferência (ex: “completed”, “busy”, “failed”)

string

Número de telefone para o qual a chamada foi transferida em formato E.164

integer

Duração da chamada de transferência em segundos

number

Custo da operadora da chamada de transferência em USD

array

Transcrição bruta da chamada de transferência (null se não disponível)

string

Transcrição formatada legível para humanos da chamada de transferência

string

URL para baixar a gravação da chamada de transferência (incluído apenas se “Include recording in webhook” estiver ativado e uma gravação existir)

string

Timestamp ISO 8601 de quando a transferência foi iniciada

string

Timestamp ISO 8601 de quando a transferência foi concluída

{
  "id": 12345,
  "customer_phone": "+1234567890",
  "assistant_phone": "+1987654321",
  "duration": 125,
  "status": "completed",
  "extracted_variables": {
    "status": true,
    "summary": "Customer interested in product demo",
    "lead_quality": "high",
    "next_action": "schedule_demo"
  },
  "input_variables": {
    "customer_name": "John Doe",
    "product_interest": "Pro Plan"
  },
  "transcript": [
    {
      "text": "Hello! This is Sarah from Sua SofIA. How are you today?",
      "type": "transcript",
      "sender": "bot",
      "timestamp": 1756812511.315143
    },
    {
      "text": "Hi, I'm doing well, thanks for calling.",
      "type": "transcript",
      "sender": "human",
      "timestamp": 1756812514.104436
    },
    {
      "text": "I'm calling to tell you about our new product features.",
      "type": "transcript",
      "sender": "bot",
      "timestamp": 1756812522.918859
    },
    {
      "text": "That sounds interesting, tell me more.",
      "type": "transcript",
      "sender": "human",
      "timestamp": 1756812525.234567
    }
  ],
  "formatted_transcript": "AI: Hello! This is Sarah from Sua SofIA. How are you today?\nCustomer: Hi, I'm doing well, thanks for calling.\nAI: I'm calling to tell you about our new product features.\nCustomer: That sounds interesting, tell me more.",
  "recording_url": "https://suasofia.online/storage/recordings/call-12345.mp4",
  "created_at": "2025-01-15T10:30:00.000000Z",
  "finished_at": "2025-01-15T10:32:05.000000Z",
  "transfers": [
    {
      "id": 12346,
      "status": "completed",
      "transfer_to": "+1555123456",
      "duration": 85,
      "carrier_cost": 0.0156,
      "transcript": null,
      "formatted_transcript": "",
      "created_at": "2025-01-15T10:31:00.000000Z",
      "finished_at": "2025-01-15T10:32:25.000000Z"
    }
  ],
  "lead": {
    "id": 789,
    "phone_number": "+1234567890",
    "variables": {
      "source": "website",
      "interest_level": "high"
    },
    "status": "contacted",
    "call_tries": 2,
    "created_at": "2025-01-15T09:00:00.000000Z",
    "updated_at": "2025-01-15T10:32:05.000000Z",
    "campaign": {
      "id": 456,
      "name": "Product Demo Campaign",
      "status": "active",
      "allowed_hours_start_time": "09:00",
      "allowed_hours_end_time": "17:00",
      "allowed_days": ["monday", "tuesday", "wednesday", "thursday", "friday"],
      "max_calls_in_parallel": 5,
      "max_retries": 3,
      "retry_interval": 60,
      "created_at": "2025-01-15T08:00:00.000000Z",
      "updated_at": "2025-01-15T08:00:00.000000Z"
    }
  }
}

Configurações do Webhook

Você pode configurar as seguintes opções para o seu webhook pós-chamada:

Send webhook only on completed: Enviar o webhook apenas para chamadas concluídas com sucesso
Include recording in webhook: Incluir o campo recording_url no payload
Custom variables: Definir variáveis personalizadas que a IA deve extrair da conversa

Observações Importantes

Os campos customer_phone e assistant_phone podem ser null se a informação não estiver disponível
O campo recording_url é incluído apenas se você tiver ativado “Include recording in webhook” nas suas configurações do assistente
O objeto lead é incluído apenas para chamadas que fazem parte de uma campanha
O array transfers é incluído apenas para chamadas que possuem chamadas de transferência associadas a elas
O objeto extracted_variables conterá as variáveis que você definiu na configuração do schema pós-chamada do seu assistente

Referência da API

Assistentes

Chamadas

Conversas

AI

Ferramentas de Chamada

Leads

Campaigns

Números de Telefone

Bases de Conhecimento

SMS

WhatsApp

Webhooks

Chaves da API

Webhook Pós-Chamada

Configuração do Webhook

Formato da Requisição

Estrutura do Payload

Configurações do Webhook

Observações Importantes

​Configuração do Webhook

​Formato da Requisição

​Estrutura do Payload

​Configurações do Webhook

​Observações Importantes

Configuração do Webhook

Formato da Requisição

Estrutura do Payload

Configurações do Webhook

Observações Importantes