Skip to main content
Configure o que acontece após o término das chamadas - extraia informações específicas de conversas e envie para sistemas externos para processamento adicional.

​
Visão Geral

Ações pós-chamada automaticamente:
  • Extraem dados estruturados de conversas usando IA
  • Enviam variáveis extraídas para webhooks para automação
  • Acionam fluxos de trabalho em plataformas conectadas
  • Atualizam registros de CRM e bancos de dados
  • Habilitam cenários de automação complexos

​
Variáveis Pós-Chamada

Defina as variáveis que a IA extrairá da chamada e enviará para um webhook.

​
Configuração de Variáveis

Configure quais informações a IA deve extrair de cada conversa:
Crie variáveis que a IA identificará e extrairá das conversas.Como funciona a extração: A IA analisa a transcrição completa da chamada e considera o contexto do seu prompt do sistema para extrair as variáveis solicitadas. Ela entende o que foi discutido durante a chamada e extrai informações relevantes com base nas descrições das suas variáveis.Configuração:
  • Nome: Identificador da variável (3-16 caracteres, minúsculas, alfanumérico)
  • Tipo: Tipo de dado para o valor extraído
  • Descrição: Explicação clara para que a IA entenda o que extrair da conversa
Tipos de Variáveis:
  • String: Valores de texto (nomes, endereços, comentários)
  • Number: Valores numéricos (quantidades, preços, pontuações)
  • True/False: Valores booleanos (respostas sim/não, objetivos alcançados)
Todo assistente inclui estas variáveis essenciais por padrão:Status (True/False): Se o objetivo da chamada foi alcançado ou nãoSummary (String): Resumo da chamada em poucas palavrasVocê pode adicionar variáveis personalizadas com base no seu caso de uso específico.
Variáveis comuns para diferentes cenários:Qualificação de vendas:
  • budget (Number): Faixa de orçamento do cliente
  • decision_maker (True/False): O chamador é o tomador de decisão
  • timeline (String): Quando eles precisam da solução
  • pain_points (String): Principais desafios mencionados
Agendamento de compromissos:
  • appointment_date (String): Data de compromisso preferida
  • service_type (String): Tipo de serviço solicitado
  • contact_method (String): Método de contato preferido
Chamadas de suporte:
  • issue_type (String): Categoria do problema
  • urgency_level (Number): Pontuação de prioridade (1-10)
  • resolution_status (True/False): O problema foi resolvido

​
Processo de Extração

A IA usa análise sofisticada para extrair variáveis das suas chamadas:Fontes de dados:
  • Transcrição completa da chamada: Tudo dito pela IA e pelo cliente
  • Contexto do prompt do sistema: Os objetivos e instruções do seu assistente ajudam a guiar a extração
  • Descrições de variáveis: Descrições claras que você fornece para cada variável
Método de análise:
  1. A IA revisa toda a transcrição da conversa
  2. Considera o prompt do sistema e objetivos da chamada
  3. Identifica informações relevantes com base nas descrições das variáveis
  4. Extrai e formata dados de acordo com os tipos especificados
  5. Valida valores extraídos antes de enviar para o webhook

​
Melhores Práticas

Nomenclatura de variáveis: Use apenas caracteres minúsculos e alfanuméricos. Sem espaços ou caracteres especiais, exceto sublinhados.
Descrições claras: Escreva descrições que expliquem claramente o que a IA deve procurar na transcrição da conversa. Quanto mais específico e consciente do contexto, melhor a precisão da extração.
Sinergia com prompt do sistema: As descrições das suas variáveis funcionam melhor quando se alinham com os objetivos do seu prompt do sistema. Se o seu assistente foi projetado para qualificação de leads, suas variáveis devem refletir esse propósito.

​
Configuração de Webhook

Faça uma solicitação para uma URL que envia as variáveis extraídas para sistemas externos.

​
Configurações de Webhook

Habilitado/Desabilitado: Controle se webhooks são enviados após chamadasPadrão: Desabilitado - Habilite apenas quando tiver um endpoint de webhook pronto para receber dados
Endpoint de URL: Para onde enviar os dados extraídosFormato: Deve ser uma URL válidaExemplo: https://automate.suasofia.online/api/v1/webhooks/your-webhook-idFuncionalidade de teste: Recurso de teste integrado envia dados de amostra para verificar conectividade
Enviar webhook apenas quando concluído:
  • Sim (Padrão): Enviar dados apenas para chamadas concluídas
  • Não: Enviar dados para todas as chamadas independentemente do status de conclusão
Incluir gravação no webhook:
  • Sim (Padrão): Incluir URL de gravação no payload do webhook
  • Não: Enviar apenas variáveis extraídas sem link de gravação

​
Payload do Webhook

O webhook receberá um payload JSON abrangente contendo detalhes da chamada, variáveis extraídas e transcrição. Para documentação completa da API, veja API de Webhook Pós-Chamada. Campos principais do payload:
  • id: Identificador único da chamada
  • customer_phone: Número de telefone do cliente (formato E.164)
  • assistant_phone: Número de telefone do assistente
  • duration: Duração da chamada em segundos
  • status: Status da chamada (initiated, ringing, busy, in-progress, ended, completed, ended_by_customer, ended_by_assistant, unanswered, failed)
  • created_at/finished_at: Carimbos de data/hora ISO 8601
  • extracted_variables: Dados extraídos pela IA com base na configuração do seu esquema pós-chamada (veja seção Variáveis Pós-Chamada acima)
  • input_variables: Variáveis passadas antes da chamada (veja Variáveis de Chamada)
  • Inclui variáveis padrão (status, summary) mais suas variáveis personalizadas
  • transcript: Transcrição detalhada da conversa com carimbos de data/hora
  • formatted_transcript: Formato de conversa legível por humanos
  • recording_url: URL de gravação da chamada (se habilitado)
  • lead: Informações do lead (para chamadas de campanha)
  • campaign: Detalhes e configurações da campanha
  • Incluído apenas para chamadas que fazem parte de campanhas
Exemplo de payload de webhook: 
{
  "id": 12345,
  "customer_phone": "+1234567890",
  "assistant_phone": "+1987654321",
  "duration": 125,
  "status": "completed",
  "extracted_variables": {
    "status": true,
    "summary": "Cliente interessado em demonstração do produto",
    "lead_quality": "high",
    "budget": 5000
  },
  "input_variables": {
    "customer_name": "João Silva",
    "product_interest": "Plano Pro"
  },
  "transcript": [
    {
      "text": "Olá! Aqui é a Sarah da Sua SofIA.",
      "type": "transcript",
      "sender": "bot",
      "timestamp": 1756812511.315143
    },
    {
      "text": "Oi, estou bem, obrigado.",
      "type": "transcript", 
      "sender": "human",
      "timestamp": 1756812514.104436
    }
  ],
  "formatted_transcript": "IA: Olá! Aqui é a Sarah da Sua SofIA.\\nCliente: Oi, estou bem, obrigado.",
  "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"
}

​
Testando Webhooks

Teste antes de entrar em produção: Use o botão “Fazer solicitação de teste” para enviar dados de amostra para o seu endpoint de webhook e verificar se está funcionando corretamente.
Processo de teste:
  1. Configure suas variáveis e URL do webhook
  2. Salve as configurações do assistente
  3. Clique em “Fazer solicitação de teste”
  4. Verifique se o seu endpoint de webhook recebe os dados de teste
  5. Verifique se a estrutura do payload corresponde às suas expectativas

​
Exemplos de Integração

​
Nossa Plataforma de Automação

Integração principal: Use nossa plataforma de automação sem código integrada para fluxos de trabalho perfeitos:
  • Processamento direto de webhook: Nenhuma configuração externa necessária
  • Mais de 250 integrações de apps: Conecte-se a CRM, email, calendários e muito mais
  • Construtor visual de fluxo de trabalho: Crie automação complexa sem código
  • Sincronização de dados em tempo real: Processamento instantâneo de variáveis extraídas
  • Modelos pré-construídos: Fluxos de trabalho prontos para uso para cenários comuns
Fluxos de trabalho de automação comuns:
  • Atualizações de CRM: Atualize automaticamente registros de contato no HubSpot, Salesforce, Pipedrive
  • Follow-ups por email: Envie emails personalizados com base nos resultados das chamadas
  • Pontuação de leads: Atualize pontuações de leads com base em variáveis extraídas
  • Agendamento de calendário: Agende reuniões de follow-up automaticamente
  • Notificações de equipe: Alerte membros da equipe sobre chamadas importantes

​
Plataformas Externas

Qualquer plataforma com suporte a webhook:
  • Receba dados de webhook da nossa plataforma
  • Processe variáveis extraídas em seus próprios sistemas
  • Crie fluxos de trabalho de automação personalizados
  • Integre com qualquer API ou serviço que aceite webhooks
Casos de uso:
  • Conecte-se a qualquer CRM, plataforma de email ou ferramenta de negócios
  • Envie dados para aplicativos personalizados
  • Acione fluxos de trabalho em plataformas de automação de terceiros
  • Armazene dados em bancos de dados ou sistemas externos

​
Desenvolvimento Personalizado

Endpoints de API: Construa receptores personalizados para dados de webhook Integração de banco de dados: Armazene dados de chamadas em seus próprios sistemas Lógica de negócios: Acione fluxos de trabalho complexos com base em variáveis extraídas

​
Testando Seu Assistente

Após configurar as configurações do assistente, é importante testar completamente antes de implantar em produção.

​
Métodos de Teste

Teste baseado na web: Use o botão “Fale com seu assistente” para testar diretamente do seu navegadorRecursos:
  • Conversa por voz em tempo real através do seu navegador web
  • Teste todas as capacidades do assistente, incluindo ferramentas e base de conhecimento
  • Não requer telefone - perfeito para iterações rápidas
  • Feedback imediato sobre respostas e comportamento
Melhor para: Teste rápido durante desenvolvimento e configuração
Teste de chamada telefônica real: Ligue para seu assistente de qualquer número de telefoneAssistentes de saída:
  • Se nenhum número específico estiver definido: Assistente liga de um número aleatório
  • Se ID de chamador estiver configurado: Assistente liga do seu número especificado
  • Teste o fluxo completo de saída, incluindo discagem e mensagem inicial
Assistentes de entrada:
  • Ligue diretamente para o número de telefone atribuído
  • Teste como o assistente gerencia chamadas recebidas
  • Verifique roteamento de chamadas e qualidade de resposta
Melhor para: Teste final com condições de telefone reais e qualidade de áudio

​
Lista de Verificação de Teste

Teste abrangente: Teste todos os recursos configurados, incluindo ferramentas, consultas de base de conhecimento, extração de variáveis e entrega de webhook.
Testes essenciais:
  • Clareza de voz e velocidade de resposta
  • Integração de base de conhecimento (se configurada)
  • Funcionalidade de ferramentas (transferência, agendamento, etc.)
  • Precisão de extração de variáveis
  • Entrega de webhook (verifique se seu endpoint recebe dados)
  • Casos extremos e tratamento de erros

​
Integração de Widget Web

Configure seu assistente para funcionar como um widget web no seu site para interações perfeitas com clientes.

​
Configuração de Widget

Integração fácil: Adicione seu assistente de IA a qualquer site com um snippet de código simplesRecursos:
  • Chat de voz: Clientes podem falar diretamente com seu assistente
  • Fallback de texto: Opção para conversas baseadas em texto
  • Aparência personalizável: Combine com as cores e estilo da sua marca
  • Responsivo para dispositivos móveis: Funciona em todos os dispositivos e tamanhos de tela
Interações inteligentes: O widget se adapta à configuração do seu assistenteCapacidades:
  • Usa a mesma base de conhecimento e ferramentas que o assistente telefônico
  • Suporta todos os idiomas configurados
  • Extrai as mesmas variáveis pós-chamada
  • Envia webhooks para conversas web
  • Respeita o mesmo prompt do sistema e personalidade
Aplicações comuns:Suporte ao cliente: Suporte automatizado 24/7 no seu site Qualificação de leads: Qualifique visitantes antes de entrarem em contato com vendas Agendamento de compromissos: Permita que visitantes agendem diretamente através do widget Tratamento de FAQ: Responda perguntas comuns instantaneamente Demonstrações de produtos: Guie visitantes através dos recursos do seu produto
Para guias detalhados de teste e instruções de integração de widget, veja nossa documentação Testando Seu Assistente.
Para guias detalhados de integração de webhook e exemplos, veja nossa documentação de Automação.