> ## Documentation Index
> Fetch the complete documentation index at: https://mayahub.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Ferramentas Mayahub

> Aprenda a usar gatilhos (triggers) e ações (actions) da Mayahub nos seus fluxos de chamadas com IA 

## Ferramentas Mayahub

A ferramenta **Mayahub** é o componente central que conecta seu sistema de chamadas com IA aos fluxos de automação.\
Ela permite a **troca de dados em tempo real** entre seus assistentes de IA e os sistemas da sua empresa, possibilitando **conversas personalizadas** e **acompanhamentos automáticos**.

<Note>
  Você pode encontrar a ferramenta **Mayahub** em destaque na parte superior da barra lateral de pesquisa, ao procurar por **gatilhos (triggers)** ou **ações (actions)**.
</Note>

## Gatilhos

### Chamada Terminada

<img src="https://mintcdn.com/mayahub/jLorboul40ctksf_/images/ma.png?fit=max&auto=format&n=jLorboul40ctksf_&q=85&s=941c9afff120a4c43ceeb5a73be20ffe" alt="ma.png" width="396" height="483" data-path="images/ma.png" />

### Chamada Encerrada

O gatilho **Chamada Encerrada** é ativado imediatamente após uma chamada de IA ser concluída, fornecendo dados completos sobre a interação:

* Transcrição completa da conversa com carimbos de tempo
* 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:

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

***

### Injeção de Variáveis em Chamadas Recebidas

Esse gatilho avançado é ativado *antes* do seu assistente de IA atender 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
* Configure traços de personalidade da IA
* Forneça variáveis de lógica de negócio

### Configuração:

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

## Ações

### Add Lead a Campanha

***

<img src="https://mintcdn.com/mayahub/jLorboul40ctksf_/images/ma2.png?fit=max&auto=format&n=jLorboul40ctksf_&q=85&s=8e43001521c9e0db7cfab39c9671ec5d" alt="ma2.png" width="723" height="534" data-path="images/ma2.png" />

### Criar Lead

Essa ação ajuda a gerenciar suas campanhas de chamadas com IA ao:

* Criar novos leads a partir de ferramentas externas como Sheets, Hubspot, Facebook Leads
* Atribuir leads a campanhas de IA específicas
* Adicionar contexto para chamadas futuras

**Configuração:**

* Selecione a campanha de IA de destino
* Mapeie os dados de contato a partir das informações do gatilho
* Adicione atributos personalizados para o contexto da IA

***

### Retornar Variáveis

Essa ação é essencial para chamadas recebidas, retornando o contexto que será injetado no prompt da IA:

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

**Configuração:**

* Estruture o JSON de resposta
* Mapeie os dados do cliente para variáveis
* Defina os parâmetros da conversa da IA
* Configure o controle de tempo limite (timeout)

***

## Exemplo de Uso

Gerenciamento de Lead Pós-Chamada

```javascript theme={null}
Trigger: AI Call Ended
↓
Extract conversation insights
↓
Update Hubspot record
↓
Add to follow-up campaign if qualified
```

### Roteamento Inteligente de Chamadas Recebidas

```javascript theme={null}
Trigger: Inbound Call to AI
↓
Fetch customer profile from CRM
↓
Get interaction history
↓
Return enriched context for AI prompt
```

## Boas Práticas

**Desempenho da Injeção de Variáveis**

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

**Estrutura de Dados**

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

**Tratamento de Erros**

* Forneça valores de fallback
* Registre falhas de injeção
* Monitore os tempos de resposta
* Trate dados ausentes de forma adequada
