> ## 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.

# Ferramenta Sua SofIA

> Aprenda a usar gatilhos e ações da Sua SofIA em seus fluxos de chamadas de IA

# Ferramenta Sua SofIA

A ferramenta Sua SofIA é o componente central que conecta seu sistema de chamadas de IA com fluxos de automação. Ela permite troca de dados em tempo real entre seus assistentes de IA e sistemas de negócios, permitindo conversas personalizadas e acompanhamentos automatizados.

<Note>
  Você pode encontrar a ferramenta Sua SofIA exibida de forma proeminente no topo da
  barra lateral de pesquisa ao procurar por gatilhos ou ações.
</Note>

## Gatilhos

### Chamada Encerrada

<img src="https://mintcdn.com/sofia-00a9d19b/J6IC9EMTb5LANhkf/resources/sofia-trigger.jpg?fit=max&auto=format&n=J6IC9EMTb5LANhkf&q=85&s=68881bdff59202ccfce653891ddd6d13" alt="Gatilho Chamada Encerrada da Sua SofIA" width="786" height="563" data-path="resources/sofia-trigger.jpg" />

O gatilho Chamada Encerrada é ativado imediatamente após a conclusão de uma chamada de IA, fornecendo dados abrangentes sobre a interação:

* Transcrição completa da conversa com carimbos de data/hora
* Respostas e decisões do assistente de IA
* Duração da chamada e metadados técnicos
* Informações do cliente e número de telefone
* Resultado da chamada e análise de sentimento
* Variáveis definidas durante a conversa

#### Configuração

1. Selecione "Chamada Encerrada" como seu gatilho
2. Escolha o assistente de IA específico para monitorar
3. Configure o mapeamento de variáveis

### Injeção de Variável de Chamada Recebida

Este poderoso gatilho é ativado antes que seu assistente de IA atenda uma chamada recebida, permitindo que você:

* Busque e injete dados do cliente em tempo real
* Personalize o comportamento da IA com base no contexto
* Defina parâmetros da conversa
* Defina traços de personalidade da IA
* Forneça variáveis de lógica de negócios

#### Configuração

1. Selecione "Chamada Recebida" como seu gatilho
2. Defina as variáveis necessárias para o contexto da IA

## Ações

### Adicionar Lead à Campanha

<img src="https://mintcdn.com/sofia-00a9d19b/J6IC9EMTb5LANhkf/resources/sofia-action.jpg?fit=max&auto=format&n=J6IC9EMTb5LANhkf&q=85&s=08f14ded83f6f5b0169661c546e7873b" alt="Ação Sua SofIA" width="786" height="580" data-path="resources/sofia-action.jpg" />

Esta ação ajuda a gerenciar suas campanhas de chamadas de IA:

* Criando novos leads de ferramentas externas como Sheets, Hubspot, leads do Facebook
* Atribuindo leads a campanhas de IA específicas
* Adicionando contexto para futuras chamadas

#### Configuração

1. Selecione a campanha de IA alvo
2. Mapeie os detalhes de contato dos dados do gatilho
3. Adicione atributos personalizados para contexto da IA

### Retornar Variáveis

Esta ação é crucial para chamadas recebidas, retornando contexto que é injetado no prompt da IA:

* Perfil e preferências do cliente
* Resumo do histórico de conversas
* Regras e restrições de negócios
* Flags de comportamento personalizado da IA
* Templates de resposta dinâmicos

#### Configuração

1. Estruture o JSON de resposta
2. Mapeie dados do cliente para variáveis
3. Defina parâmetros de conversa da IA
4. Configure o tratamento de timeout

## Exemplo de Uso

### Gestão de Leads Pós-Chamada

```javascript theme={null}
Gatilho: Chamada de IA Encerrada
↓
Extrair insights da conversa
↓
Atualizar registro no Hubspot
↓
Adicionar à campanha de acompanhamento se qualificado
```

### Roteamento Inteligente de Chamadas Recebidas

```javascript theme={null}
Gatilho: Chamada Recebida para IA
↓
Buscar perfil do cliente no CRM
↓
Obter histórico de interações
↓
Retornar contexto enriquecido para prompt da IA
```

## Melhores Práticas

1. **Performance de Injeção de Variáveis**

   * Mantenha o processamento abaixo de 2 segundos
   * Defina valores padrão sensatos

2. **Estrutura de Dados**

   * Siga os requisitos do prompt da IA
   * Valide todas as variáveis
   * Estruture objetos aninhados claramente
   * Documente campos personalizados

3. **Tratamento de Erros**
   * Forneça valores de fallback
   * Registre falhas de injeção
   * Monitore tempos de resposta
   * Trate dados ausentes de forma elegante