> ## Documentation Index
> Fetch the complete documentation index at: https://docs.suasofia.online/llms.txt
> Use this file to discover all available pages before exploring further.
# Ações Pós-Chamada
> Extraia dados da chamada e envie para um app/webhook para fluxos de trabalho de automação.
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ão
**Summary (String):** Resumo da chamada em poucas palavras
Você 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 chamadas
**Padrão:** Desabilitado - Habilite apenas quando tiver um endpoint de webhook pronto para receber dados
**Endpoint de URL:** Para onde enviar os dados extraídos
**Formato:** Deve ser uma URL válida
**Exemplo:** `https://automate.suasofia.online/api/v1/webhooks/your-webhook-id`
**Funcionalidade 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](/api-reference/webhooks/post-call-webhook).
**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](#variáveis-pós-chamada) acima)
* **input\_variables:** Variáveis passadas antes da chamada (veja [Variáveis de Chamada](/ai-assistants/settings/prompt-and-tools#call-variables))
* 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:**
```json theme={null}
{
"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 navegador
**Recursos:**
* 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 telefone
**Assistentes 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 simples
**Recursos:**
* **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 assistente
**Capacidades:**
* 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](/ai-assistants/testing).
Para guias detalhados de integração de webhook e exemplos, veja nossa documentação de [Automação](/automation/overview).