Skip to main content
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:
  1. Configure a URL do webhook do seu assistente nas configurações do assistente
  2. Habilite “Post call webhook” na configuração do assistente
  3. 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

​
id
integer
Identificador único da chamada
​
customer_phone
string
Número de telefone do cliente em formato E.164 (ex: “+1234567890”) ou null se não disponível
​
assistant_phone
string
Número de telefone usado pelo assistente em formato E.164 ou null se não disponível
​
duration
integer
Duração da chamada em segundos
​
status
string
Status final da chamada (ex: “completed”, “busy”, “failed”)
​
extracted_variables
object
Variáveis extraídas pela IA com base na configuração do seu schema pós-chamada
​
input_variables
object
Variáveis que foram passadas para o assistente antes da chamada começar
​
transcript
string
Transcrição completa da conversa
​
recording_url
string
URL para baixar a gravação da chamada (incluída apenas se “Include recording in webhook” estiver habilitado nas configurações do assistente)
​
created_at
string
Timestamp ISO 8601 de quando a chamada foi iniciada
​
finished_at
string
Timestamp ISO 8601 de quando a chamada foi concluída (usa updated_at do registro da chamada)
​
lead
object
Informações do lead (incluído apenas para chamadas de campanha)
{
  "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",
  "lead": {
    "id": 789,
    "phone_number": "+1234567890",
    "variables": {
      "source": "website",
      "interest_level": "high"
    },
    "status": "contacted",
    "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ê habilitou “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 objeto extracted_variables conterá as variáveis que você definiu na configuração do schema pós-chamada do seu assistente