Ações e Ferramentas

A aba Actions é onde gere tudo o que o seu agente pode fazer para além da conversa — ferramentas que o agente chama durante uma conversa ao vivo, prefetch hooks que correm antes da chamada começar, e ações pós-chamada que disparam uma vez a chamada termine. As Variáveis de Recolha (os campos de dados que o agente extrai de cada conversa) vivem na mesma aba.

Todos os Planos

Todas as ferramentas, ações e o novo pre-fetch hook estão disponíveis em todos os planos, incluindo Free.

As Três Fases

Cada entrada na aba Actions pertence a uma de três fases do ciclo de vida. O dropdown Add Tool agrupa-as para que seja claro quando cada coisa dispara:

Fase	Quando	Exemplos
Pre fetch	Antes do agente dizer olá	Procurar o interlocutor no seu CRM por telefone, puxar o último pedido, obter uma saudação personalizada do seu backend
Live call	Durante a conversa, acionada pela IA quando o momento é certo	Encaminhar a chamada para um humano, verificar disponibilidade de calendário, transferir para outro agente, consultar uma API externa para dados
Post call	Depois da chamada terminar	Enviar um email de resumo, disparar uma confirmação SMS, enviar o payload da chamada para o seu CRM

O dropdown abre com Pre fetch no topo porque cada outra fase já tem muitas opções — a nova entrada de pre-fetch é a coisa mais provável que está a procurar.

Pre fetch

Os pre-fetch hooks permitem que o seu agente comece a chamada já sabendo quem está a ligar. Correm em paralelo com a configuração da chamada e injetam a resposta no prompt do sistema do agente antes da primeira palavra ser falada.

Quando usar

Reconhecer um cliente que volta pelo número de telefone e cumprimentá-lo pelo nome
Puxar o pedido aberto do interlocutor, último compromisso, ou tier de membership
Pré-carregar contexto de negócio que depende de qual linha foi marcada
Injetar notas do CRM para que o agente saiba a etapa e história do lead

Como funciona

A plataforma resolve o telefone do interlocutor (do SIP para inbound, do destino marcado para outbound).
Cada ação Pre fetch ativa dispara em paralelo com um timeout estrito de 1,5 s por pedido e um orçamento global de 2 s.
As respostas bem-sucedidas são concatenadas no prompt do sistema do agente como blocos nomeados — o agente lê-os no seu primeiro turno.
As falhas são silenciosas — um endpoint lento ou partido nunca bloqueia a saudação. O agente simplesmente começa a falar sem esse bloco.

Configuração

Campo	Descrição
Name	Obrigatório. Rótulo interno e nome do bloco no prompt — mantenha-o curto e descritivo (ex. `crm_lookup`, `vip_check`).
API URL	Obrigatório. Endpoint para obter. Suporta placeholders `{phone}`, `{direction}`, `{agent_id}`, `{user_id}`, `{call_id}`.
HTTP Method	`GET` é o padrão e a melhor escolha. `POST` / `PUT` / `PATCH` / `DELETE` também funcionam.
Headers	Opcional. Estáticos ou com templates (os placeholders também funcionam aqui).
Query Parameters	Opcional. Pré-preenche com `phone={phone}` para novas ações pre-fetch.

Variáveis disponíveis

Estes tokens são substituídos em URL, headers e parâmetros de query/body no momento do pedido:

Variável	Origem	Valor de exemplo
`{phone}`	Telefone do interlocutor (E.164) — para outbound, o número de destino	`+431234567890`
`{direction}`	`inbound` ou `outbound`	`inbound`
`{agent_id}`	ID interno do agente	`65f1a2b3c4...`
`{user_id}`	ID do proprietário do workspace	`65e0b1c2d3...`
`{call_id}`	ID da chamada (deixa o seu backend correlacionar payload pós-chamada mais tarde)	`65f1f2c4d5...`

Placeholders desconhecidos são deixados verbatim — templating mau nunca faz cair uma chamada.

O que cai no prompt

Se o seu endpoint em https://crm.example.com/lookup?phone={phone} devolve:

{ "name": "Sarah Johnson", "tier": "Gold", "open_orders": 1 }

O prompt do sistema do agente é acrescentado com um bloco wrapped em XML nomeado a partir da ação:

<call_context>
  <block name="crm_lookup">
  { "name": "Sarah Johnson", "tier": "Gold", "open_orders": 1 }
  </block>
</call_context>

Não precisa de dizer ao agente como o usar — o LLM apanha o contexto naturalmente. Opcionalmente, mencione o pre-fetch no seu prompt do sistema: "Se <call_context> contém um nome de cliente, cumprimente-o pelo nome."

Restrições importantes

Apenas chamadas telefónicas. O pre-fetch não corre para chamadas via widget (web) — não há número de telefone para usar no template.
Limite de 8 KB no corpo da resposta — qualquer coisa mais longa é truncada antes da injeção. O limite protege o seu orçamento de tokens do prompt e limita o raio de explosão de um endpoint malicioso.
Sem avaliação de condition — o pre-fetch sempre dispara quando ativo. Ainda não há transcrição para avaliar.

dica

Use GET com um endpoint de lookup por chave de telefone. Mantenha as respostas pequenas e estruturadas (objeto JSON com 3-5 campos). O agente não precisa do seu registo completo de cliente — apenas dos bits que mudam a conversa.

Ferramentas Live Call

Estas correm durante a conversa. A IA decide quando chamar cada ferramenta com base na sua descrição e no diálogo atual.

Ferramentas Disponíveis

Ferramenta	Finalidade	Quando usar
Call Forwarding	Transferir para um operador humano	O cliente pede uma pessoa, problemas complexos
Google Calendar	Verificar disponibilidade e marcar compromissos	O cliente quer agendar uma reunião
Outlook Calendar	Igual, via Microsoft Outlook	O cliente quer agendar uma reunião
API Tool RAG	Obter dados ao vivo de uma API externa	Precisa de info em tempo real (pedidos, stock, estado de conta)
Agent Transfer	Transferir para outro agente de voz IA	O interlocutor precisa de um departamento ou especialista diferente
HubSpot CRM	Ler/escrever contactos e negócios no HubSpot	Registar a chamada no HubSpot, procurar um lead
MCP servers	Expor ferramentas de qualquer um dos seus servidores MCP registados	Executa um servidor de ferramentas compatível com MCP e quer que o agente use as suas ferramentas a meio da conversa

Call Forwarding

Transfere chamadas para um humano quando condições específicas são cumpridas.

Definição	Descrição	Exemplo
Name	Obrigatório. Nome da pessoa ou departamento	`"Sales Manager"`
Forwarding Number	Número de telefone padrão para o qual transferir	`"+49 123 456 789"`
Trigger Condition	Quando o agente deve transferir	`"Cliente pede gerente ou problema não pode ser resolvido"`
Conditional Routing Numbers	Mapeamento de condição-para-número para encaminhamento	`{"billing": "+49 111 222", "technical": "+49 333 444"}`

Como funciona:

Durante uma conversa, a IA avalia a Trigger Condition.
Se números de encaminhamento condicional estão definidos, a condição correspondente determina que número chamar.
Caso contrário, o Forwarding Number é usado.
O agente informa o interlocutor sobre a transferência.
A chamada é encaminhada — se não houver atendimento, regressa ao agente.

dica

Pode adicionar várias ferramentas Call Forwarding para diferentes departamentos — uma para "Vendas" e outra para "Suporte Técnico" com diferentes condições e números.

Google Calendar

Ligue o seu Google Calendar para que o agente possa verificar disponibilidade e marcar compromissos durante as chamadas.

Configuração:

Vá a Integration → Calendars e ligue a sua conta Google primeiro.
Adicione a ferramenta Google Calendar na aba Actions do agente.
Selecione o calendário a usar.
Configure as suas definições de disponibilidade.

Definição	Descrição	Padrão
Calendar	Obrigatório. Que calendário usar	O seu calendário principal
Timezone	Fuso horário para compromissos (formato IANA)	Auto-detetado
Work Start Time	Início do horário de trabalho	9:00
Work End Time	Fim do horário de trabalho	18:00
Slot Duration	Comprimento do compromisso em minutos	30
Working Days	Dias da semana disponíveis	Segunda a Sexta
Buffer Between Appointments	Margem entre compromissos (0–60 min)	0

Durações de slot suportadas: 15, 30, 45, 60, 75, 90, 105, 120 minutos.

dica

Configure as suas horas e dias de trabalho com precisão — o agente irá oferecer apenas slots de tempo dentro da sua disponibilidade configurada.

Outlook Calendar

Ligue o seu Outlook Calendar para agendamento de compromissos durante as chamadas. Funciona da mesma forma que o Google Calendar.

Configuração:

Vá a Integration → Calendars e ligue a sua conta Outlook primeiro.
Adicione a ferramenta Outlook Calendar na aba Actions do agente.
Selecione o calendário a usar.
Configure as suas definições de disponibilidade.

As definições são idênticas ao Google Calendar (fuso horário, horas de trabalho, duração de slot, dias de trabalho, buffer).

Agent Transfer

Transfira uma chamada para outro agente de voz IA na sua conta. Útil quando tem agentes especializados para diferentes departamentos.

Definição	Descrição
Target Agent	Obrigatório. Selecione para que agente transferir
Trigger Condition	Quando transferir (ex.: "Interlocutor pergunta sobre suporte técnico")

Exemplo: Um agente de receção transfere interlocutores para um agente de vendas quando perguntam sobre preços, ou para um agente de suporte quando têm um problema técnico.

HubSpot CRM

Ler e escrever no seu CRM HubSpot durante a chamada. Permite ao agente registar interações, procurar um contacto por telefone ou enviar atualizações de negócio sem ter de escrever as chamadas de API.

Configuração:

Vá à página Integrations e ligue a sua conta HubSpot.
Adicione a ferramenta HubSpot CRM na aba Actions do agente.
Selecione que pipeline e propriedades o agente deve poder tocar.

Depois de a ferramenta ser adicionada, a IA pode corresponder o interlocutor a um contacto HubSpot por telefone, obter etapa do negócio e atualizar campos — tudo a partir da conversa ao vivo.

MCP servers

Exponha ferramentas de qualquer servidor compatível com MCP que tenha ligado à Hanc.AI. Um agente pode puxar de vários servidores MCP; um servidor MCP pode servir vários agentes.

Configuração:

Ligue o(s) seu(s) servidor(es) MCP uma vez em Integration → MCP servers. Veja a página dedicada Servidores MCP para passos completos de registo.
Adicione a entrada MCP servers à aba Actions deste agente — está agrupada em Live call no dropdown Add Action.
Ative quais das suas ligações registadas este agente deve ter acesso.
Adicione uma instrução curta "When to use it" para que o agente saiba quando recorrer a estas ferramentas.

O agente re-descobre o conjunto de ferramentas de cada servidor MCP ativado no início de cada chamada, por isso alterações que faça no lado do servidor aparecem automaticamente na próxima chamada. As ferramentas são renomeadas com o rótulo da ligação como prefixo para que ferramentas com nomes semelhantes de servidores diferentes não colidam.

API Tool RAG

Ligue a APIs externas para obter informação em tempo real durante as chamadas — procurar pedidos, verificar inventário, verificar contas, ou aceder a quaisquer dados disponíveis via API.

Definição	Descrição	Exemplo
Name	Obrigatório. Nome da ferramenta	`"Order Lookup"`
Description / When to Use	Obrigatório. Quando consultar a API	`"Cliente pergunta sobre estado do pedido"`
API URL	Obrigatório. Endpoint da API. Pode incluir tokens `{placeholder}` que serão substituídos por valores do Body Parameters Schema (ver abaixo).	`"https://api.yourshop.com/orders/{order_id}"`
HTTP Method	Obrigatório. Método HTTP	`GET`, `POST`, `PUT`, `DELETE`, `PATCH`
Loading Message	O que o agente diz enquanto espera	`"Deixa-me verificar isso por ti..."`
Timeout	Tempo máximo de espera (ms)	`5000` (padrão)
Headers	Headers HTTP estáticos enviados com cada pedido	`{"Authorization": "Bearer KEY"}`
Query Parameters	Parâmetros estáticos de query string adicionados a cada pedido	`{"apiVersion": "v2"}`
Body Parameters Schema	Obrigatório. JSON Schema que descreve os argumentos que a IA deve extrair da conversa e passar à ferramenta. Veja Escrever o Body Parameters Schema.	Objeto JSON Schema

dica

Defina sempre uma Loading Message — silêncio durante chamadas de API parece partido ao interlocutor.

observação

A antiga checkbox "Run on call start" na API Tool RAG foi substituída pela entrada dedicada Pre fetch. Use Pre fetch quando quer os dados antes da conversa começar; use API Tool RAG quando o agente deve decidir durante a chamada se deve obter.

Escrever o Body Parameters Schema

Apesar do nome, Body Parameters Schema não é um body de pedido raw. É um JSON Schema que descreve o que a IA deve extrair da conversa e passar à sua ferramenta. Dependendo do método HTTP e do template do URL, estes valores acabam no URL, na query string ou no body JSON:

Método HTTP	Onde os valores extraídos vão
URL contém `{name}`	O valor correspondente é substituído no URL
`GET`, `DELETE`	Os valores restantes são acrescentados ao URL como `?key=value`
`POST`, `PUT`, `PATCH`	Os valores restantes são enviados como body JSON

Estrutura mínima

{
  "type": "object",
  "properties": {
    "param_name": {
      "type": "string",
      "description": "O que este valor é e como a IA deve escolhê-lo"
    }
  },
  "required": ["param_name"]
}

O type raiz é sempre "object". properties lista cada argumento. required marca quais a IA deve sempre fornecer — se o cliente ainda não disse, a IA irá perguntar antes de chamar a ferramenta.

Referência de campos

Campo	Finalidade
`type`	Tipo JSON do valor: `"string"`, `"number"`, `"integer"`, `"boolean"`, `"array"`, `"object"`
`description`	Mais importante. Diz à IA o que o valor significa, que formato usar, e quando fornecer. Adicione exemplos sempre que possível.
`enum`	Restringe o valor a um de uma lista fixa. A IA irá mapear fala natural para a opção mais próxima (ex. `"o azul"` → `"blue"`).
`minimum`, `maximum`	Limites numéricos. A IA irá recusar/limitar valores fora do intervalo.
`default`	Valor usado quando a IA não passa este campo. Não obrigatório, mas documenta o valor implícito.
`format`	Dica de validação, ex. `"email"`, `"date"` (YYYY-MM-DD), `"uri"`.

Exemplos

Pesquisa de produto (apenas keyword):

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Palavra-chave de pesquisa de produto — ex. \"phone\", \"laptop\", \"Apple\", \"Samsung\""
    }
  },
  "required": ["query"]
}

Usado com URL https://dummyjson.com/products/search?q={query}&limit=5 e GET: o valor query vai para o placeholder do URL. Nada acaba no body.

Lookup de pedido por ID:

{
  "type": "object",
  "properties": {
    "order_id": {
      "type": "string",
      "description": "ID do pedido sobre o qual o cliente está a perguntar, geralmente 6 a 10 dígitos. Pergunte ao cliente se não for fornecido."
    }
  },
  "required": ["order_id"]
}

Usado com URL https://api.example.com/orders/{order_id} e GET.

Reserva com vários campos obrigatórios:

{
  "type": "object",
  "properties": {
    "product_id": {
      "type": "string",
      "description": "ID do produto devolvido por uma chamada search_products anterior."
    },
    "quantity": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "description": "Quantos itens reservar. Padrão 1."
    },
    "delivery_method": {
      "type": "string",
      "enum": ["pickup", "home_delivery", "locker"],
      "description": "Como o cliente quer receber o item."
    },
    "customer_email": {
      "type": "string",
      "format": "email",
      "description": "Email do cliente para confirmação do pedido. Pergunte se não fornecido."
    }
  },
  "required": ["product_id", "delivery_method", "customer_email"]
}

Usado com POST https://api.example.com/reservations: os quatro valores vão para o body JSON. A IA irá pedir ao cliente os campos required em falta antes de chamar a ferramenta.

Ferramenta sem parâmetros:

{
  "type": "object",
  "properties": {}
}

Use isto quando o endpoint é totalmente estático (ex. GET /store/hours) e a IA não precisa de passar nada.

Boas práticas para agentes de voz IA

Mantenha o schema plano. Objetos e arrays aninhados funcionam, mas a IA pode escorregar ao falar ao telefone. Prefira 3–5 campos top-level no máximo.
Escreva sempre uma description para cada campo. Inclua exemplos (ex. "phone", "laptop") — exemplos guiam a IA de forma mais fiável do que definições abstratas.
Use enum sempre que tem uma lista fixa de valores. Remove o risco de a IA inventar valores ou enviar "Electronics" em vez de "electronics".
Marque um campo required apenas se a ferramenta não funciona sem ele. Tudo o resto é opcional, e a IA irá saltá-lo quando o cliente não mencionar — sem perguntas extras estranhas.
Use nomes em snake_case e corresponda exatamente a quaisquer tokens {placeholder} no URL.
Documente comportamento para valores em falta na description — ex. "Omita se não há limite de orçamento", "Padrão 5".

Ações Pós-Chamada

As ações pós-chamada disparam uma vez a chamada termine e a cadeia de análise produza o resumo, sentimento e variáveis extraídas. Consomem dados da chamada — não falam com o cliente.

Ações Disponíveis

Ação	Finalidade
Send Email	Email um resumo estruturado para a sua equipa ou cliente
Send SMS	Confirmação por texto ao interlocutor
Send WhatsApp	Mensagem ou template WhatsApp (funciona dentro e fora da janela de 24 horas)
API Call	Envia o payload completo da chamada para uma API externa (CRM, webhook, o seu data warehouse)

Send Email

Definição	Descrição
Name	Obrigatório. Identificador da ação
Subject	Obrigatório. Assunto do email
Message Body	Obrigatório. Corpo do email — pode incluir variáveis de recolha
Trigger Condition	Quando enviar (vazio = sempre)
Recipients	Obrigatório. Endereços de email que recebem sempre o email
Conditional Recipients	Mapeamento de condição-para-destinatário

Usar variáveis no email:

Novo lead de chamada telefónica:

Nome: {{customer_name}}
Email: {{customer_email}}
Interessado em: {{selected_plan}}
Notas: {{call_notes}}

Send SMS

Definição	Descrição
Name	Obrigatório. Identificador da ação
Sender Name	Nome do remetente apresentado
Message	Obrigatório. Conteúdo SMS (pode incluir variáveis)
Trigger Condition	Quando enviar
Recipients	Obrigatório. Números de telefone que recebem sempre o SMS
Conditional Recipients	Mapeamento de condição-para-número

Send WhatsApp

O envio de mensagens WhatsApp na HANC usa templates pré-aprovados de uma conta central Twilio Content — não cola um Template SID à mão. O editor de ação mostra um dropdown de cada template atualmente ativo e aprovado, e você escolhe um. Os placeholders dentro do template ({{1}}, {{2}}, …) são depois preenchidos inline a partir de variáveis de chamada ou texto estático que mapeia no editor.

Definição	Descrição
Name	Obrigatório. Identificador da ação
Trigger Condition	Quando enviar
Recipients	Obrigatório. Números de telefone que recebem sempre a mensagem
Conditional Recipients	Mapeamento de condição-para-número
Template	Obrigatório. Seletor dropdown de templates WhatsApp pré-aprovados sincronizados da conta central Twilio Content. Cada entrada mostra o nome do template, língua e uma pré-visualização do corpo para que saiba qual escolher.
Template Variables	Para o template que escolheu, o editor lista cada placeholder (`{{1}}`, `{{2}}`, …) e deixa-o mapear cada um a uma variável de chamada (ver abaixo) ou uma string estática.

Variáveis de chamada disponíveis que pode mapear para placeholders de template:

Variável	Descrição
`{{call_from}}`	Número de telefone do interlocutor
`{{call_to}}`	Número que foi chamado
`{{call_summary}}`	Resumo da chamada gerado pela IA
`{{call_sentiment}}`	Sentimento (positivo/neutro/negativo)
`{{call_task_achieved}}`	Se a tarefa da chamada foi alcançada
`{{call_transcription}}`	Transcrição completa da chamada

Porquê um seletor, não texto livre

O WhatsApp requer que cada mensagem iniciada pelo negócio fora da janela de atendimento ao cliente de 24 horas use um template pré-aprovado. A HANC sincroniza a lista de templates aprovados da conta partilhada Twilio Content, por isso o dropdown mostra sempre exatamente o que está elegível para enviar agora — não pode escolher acidentalmente um draft, um template rejeitado ou um SID que não existe. Para adicionar um novo template, contacte o suporte; uma vez aprovado pelo WhatsApp, aparece no dropdown automaticamente.

API Call

A ação API Call pós-chamada é o seu webhook genérico para o resto do seu stack. Escolha o método, defina o URL, e vamos enviar o payload completo da chamada — o seu endpoint recebe um objeto JSON estruturado a descrever o que aconteceu.

Definição	Descrição
Name	Obrigatório. Identificador da ação
Trigger Condition	Quando disparar (vazio = cada chamada). Avaliado por um LLM contra a transcrição.
API URL	Obrigatório. URL do endpoint da API
HTTP Method	Obrigatório. `GET`, `POST`, `PUT`, `DELETE`, `PATCH`
Headers	Headers de pedido opcionais
Query Parameters	Parâmetros opcionais de query string

O que o seu endpoint recebe

Para POST / PUT / PATCH, o seu endpoint recebe um objeto JSON no corpo do pedido. Os seus parâmetros de body configurados são fundidos com o payload completo da chamada:

{
  "call_from": "+431234567890",
  "call_to":   "+439876543210",
  "direction": "inbound",
  "call_type": "phone",
  "call_status": "ended",
  "start_timestamp": 1730000000000,
  "end_timestamp":   1730000187000,
  "duration": 187000,
  "transcription": [
    { "speaker": "agent", "content": "Hello…", "timestamp": 1730000001000 },
    { "speaker": "user",  "content": "Hi…",    "timestamp": 1730000003000 }
  ],
  "call_summary": "Customer asked about pricing…",
  "task_achieved": true,
  "sentiment": { "sentiment": "positive", "explanation": "…" },
  "custom_analysis_data": {
    "name": "John",
    "email": "john@example.com"
  },
  "collected_data": { /* submissões de formulário durante a chamada */ },
  "transfer_history": [ /* se alguma transferência de agente aconteceu */ ],
  "recording_url": "https://…",
  "disconnection_reason": "user_hangup",
  "is_anonymous": false,
  "is_simulation": false,
  "created_at": 1730000000000,
  "updated_at": 1730000187000
}

Para GET / DELETE, os mesmos campos são achatados na query string — mas valores aninhados como transcription, sentiment e custom_analysis_data são deixados cair (URLs não conseguem carregar dados estruturados de forma sã). Use POST/PUT/PATCH se precisar da transcrição.

Cada pedido também recebe um header X-Correlation-Id para tracing, e faz timeout após 30 segundos.

Pre-fetch vs API Call Pós-Chamada

Pre fetch templates {phone} etc. em URL/headers/query/body. Devolve para dentro do prompt, antes da chamada.
Post call API Call envia o dump completo da chamada no body ou query. Sem templating de URL — o seu endpoint recebe URL estático + body dinâmico.

Variáveis de Recolha

As Variáveis de Recolha são campos de dados personalizados que a IA extrai automaticamente das conversas. Por exemplo, o agente pode capturar o nome do interlocutor, email, número de telefone ou qualquer outra informação que defina.

Variáveis Padrão

Cada novo agente é criado com duas variáveis de recolha padrão:

Variável	Tipo	Descrição
Email	Email	Endereço de email do interlocutor
Phone	Phone	Número de telefone do interlocutor

Estas estão ativadas por defeito e mostradas no formulário do widget de chamada. Pode editá-las ou removê-las, e adicionar as suas próprias variáveis personalizadas.

Tipos de Variável

Tipo	Caso de Uso	Exemplo
Text	Nomes, moradas, notas, entrada livre	Nome do cliente, morada de entrega
Number	Quantidades, orçamentos, IDs	Quantidade do pedido, valor do orçamento
Email	Endereços de email com validação	Email do cliente
Phone	Números de telefone com validação	Número de telefone do cliente
Selector	Escolha de opções predefinidas	Plano preferido (Basic/Pro/Enterprise)
Checkbox	Consentimento ou confirmação sim/não	"Concordo em receber emails de marketing"

Configurar uma Variável

Campo	Descrição	Exemplo
Variable Name	Obrigatório. Identificador da variável	`customer_email`
Instructions for AI	Obrigatório. Instruções para a IA sobre quando e como extrair este valor	`"O endereço de email do cliente. Pergunte se não fornecido."`
Example Format	(Opcional) Exemplo do formato esperado	`"john@example.com"`
Options (for Selector)	(Apenas Selector) Lista de opções permitidas	`["Basic", "Pro", "Enterprise"]`
Show in Form	Se mostrar este campo no formulário do widget de chamada	Ativado por defeito

Show in Form

Quando Show in Form está ativado, a variável aparece como um campo de input visível no widget web antes e durante a chamada. Isto deixa os interlocutores preencher a sua informação diretamente, em adição à IA extraí-la da conversa.

dica

A IA irá perguntar naturalmente por informação em falta durante a conversa. Defina uma descrição clara como "Endereço de email do cliente, pergunte educadamente se não fornecido" e o agente irá tratar disso.

Adicionar Ferramentas e Ações

Navegue para a aba Actions do seu agente.
Clique em Add Tool.
Escolha a fase certa do dropdown — Pre fetch, Live call ou Post call.
Configure as definições.
Guarde — as alterações aplicam-se na próxima chamada.

Todas as entradas são listadas em conjunto na tabela Actions. Clique em qualquer linha para editar, ou use o ícone do caixote do lixo para eliminar.

Relacionados

Visão Geral de Agentes de Voz IA
Engenharia de Prompts — Referenciar ferramentas no seu prompt
Base de Conhecimento — Fontes de informação
Integrações — Sistemas externos com que as suas ferramentas podem falar

As Três Fases​

Pre fetch​

Quando usar​

Como funciona​

Configuração​

Variáveis disponíveis​

O que cai no prompt​

Restrições importantes​

Ferramentas Live Call​

Ferramentas Disponíveis​

Call Forwarding​

Google Calendar​

Outlook Calendar​

Agent Transfer​

HubSpot CRM​

MCP servers​

API Tool RAG​

Escrever o Body Parameters Schema​

Estrutura mínima​

Referência de campos​

Exemplos​

Boas práticas para agentes de voz IA​

Ações Pós-Chamada​

Ações Disponíveis​

Send Email​

Send SMS​

Send WhatsApp​

API Call​

O que o seu endpoint recebe​

Variáveis de Recolha​

Variáveis Padrão​

Tipos de Variável​

Configurar uma Variável​

Show in Form​

Adicionar Ferramentas e Ações​

Relacionados​

As Três Fases

Pre fetch

Quando usar

Como funciona

Configuração

Variáveis disponíveis

O que cai no prompt

Restrições importantes

Ferramentas Live Call

Ferramentas Disponíveis

Call Forwarding

Google Calendar

Outlook Calendar

Agent Transfer

HubSpot CRM

MCP servers

API Tool RAG

Escrever o Body Parameters Schema

Estrutura mínima

Referência de campos

Exemplos

Boas práticas para agentes de voz IA

Ações Pós-Chamada

Ações Disponíveis

Send Email

Send SMS

Send WhatsApp

API Call

O que o seu endpoint recebe

Variáveis de Recolha

Variáveis Padrão

Tipos de Variável

Configurar uma Variável

Show in Form

Adicionar Ferramentas e Ações

Relacionados