Ferramentas Nativas

1. Selecione o nó de Agente de IA no seu fluxo
2. Abra a seção TOOLS na configuração do nó
3. Clique no botão ”+ Adicionar ferramentas”
4. No campo “Selecionar uma Ferramenta”, você verá a lista de todas as ferramentas disponíveis, incluindo as nativas (marcadas com o texto “(Native)”)

​

Busca de produtos

“Se o usuário perguntar sobre a disponibilidade de um item ou modelo específico, você DEVE usar a ferramenta search_products para consultar o catálogo antes de responder.”

{
  "product": "iPhone 15 Pro",
  "top_k": 5,
  "score_threshold": 0.85
}

• Requer que o canal tenha um catálogo de produtos configurado e acessível.

​

Transferir para agente

“Quando o usuário expressar frustração ou solicitar explicitamente falar com uma pessoa real, execute a função transfer_to_agent imediatamente.”

{
  "assignment_type": "direct",
  "assignment_by": "shuffle"
}

{
  "assignment_type": "direct",
  "assignment_by": "team",
  "teamId": 4501
}

{
  "assignment_type": "queue",
  "assignment_by": "general",
  "priority": 5
}

• Pode encerrar o fluxo de IA imediatamente.
• Ao usar assignment_type: "queue" com assignment_by: "general", um ticket é criado na fila geral de atendimento.
• Importante: IDs de equipe ou operador não devem ser inventados; use apenas os explicitamente configurados.

​

Mensagens interativas

​

Configurações gerais: Botões e lista

​

Mensagens personalizadas: Webview e Apelo à ação

​

Campos do Webview

​

Campos do Apelo à ação

​

Canais compatíveis

​

Botões e lista

• title (string, obrigatório): Texto da opção/botão. Máximo de 20 caracteres. Títulos duplicados não são permitidos.
• description (string, opcional): Descrição adicional da opção. Máximo de 72 caracteres.

“Se o usuário perguntar quais serviços oferecemos, você DEVE usar send_interactive_message para exibir um menu com as opções disponíveis.”

{
  "text": "Como você gostaria de continuar com sua consulta?",
  "title": "Opções de Atendimento",
  "caption": "Selecione uma opção",
  "options": [
    {
      "title": "Falar com Agente",
      "description": "Transferir para suporte humano"
    },
    {
      "title": "Ver Catálogo",
      "description": "Navegar pelos produtos disponíveis"
    }
  ]
}

{
  "text": "Temos vários departamentos disponíveis para atendê-lo.",
  "title": "Departamentos",
  "caption": "Ver opções",
  "options": [
    { "title": "Vendas", "description": "Consultas sobre produtos e preços" },
    { "title": "Suporte Técnico", "description": "Ajuda com problemas técnicos" },
    { "title": "Faturamento", "description": "Consultas sobre pagamentos" },
    { "title": "Devoluções", "description": "Gerenciar devoluções" }
  ]
}

• Envia uma mensagem real ao usuário.
• O tipo de mensagem se adapta automaticamente de acordo com o canal e o número de opções.

​

Enviar Call to Action (CTA) (Legacy)

“Quando o usuário confirmar que deseja fazer o pagamento, use send_call_to_action com is_webview=true para enviar o link de pagamento e aguardar a confirmação.”

{
  "text": "Visite nossa loja online para ver todos os produtos disponíveis.",
  "url": "https://store.example.com/catalog",
  "display_text": "Ver Catálogo",
  "title": "Loja Online"
}

{
  "text": "Clique no botão para concluir seu pagamento com segurança.",
  "url": "https://payments.example.com/checkout",
  "display_text": "Pagar Agora",
  "title": "Concluir Pagamento",
  "is_webview": true,
  "expiration_time": 600,
  "pending_message": "Por favor, conclua o pagamento na janela aberta antes de continuar.",
  "response_variable": "payment_result",
  "input": {
    "order_id": "12345",
    "amount": 99.99
  }
}

• CTA normal: "Call-to-action message sent successfully."
• WebView: "WebView message sent. Waiting for user action."

• Disponível apenas para provedores do WhatsApp que suportam esse tipo de mensagem.
• Quando is_webview=true, o fluxo é pausado até que o WebView retorne um callback ou o tempo expire.
• O valor de input é convertido em parâmetros de query string da URL.
• A resposta do callback é salva na variável especificada em response_variable.

​

Responder com notas de voz

• O turno do agente termina ao enviar a nota de voz. A ferramenta sempre pausa; isso não é configurável.
• A plataforma escolhe a voz. Não há um campo para selecioná-la.
• Você só pode editar a descrição da ferramenta; ela não tem parâmetros nem a seção de comportamento.

​

Data e hora atual

“Antes de processar qualquer solicitação dependente de horário (como ‘bom dia’ ou compromissos para ‘hoje’), chame get_current_date_time para saber o horário exato.”

{
  "timezone": "America/Sao_Paulo"
}

• Não tem efeitos colaterais visíveis para o usuário.
• É puramente informacional para o modelo.

​

Dia da semana

“Se o usuário quiser agendar para uma data específica, verifique primeiro qual dia da semana é usando get_weekday_of_a_date para garantir que seja um dia útil.”

{
  "date": "2025-12-10"
}

• Útil para validar compromissos ou agendas.

​

Gerenciamento de memória

​

Memória interna

• Inclui um campo opcional Espaço de memória para isolar ou agrupar os registros salvos, evitando que contextos diferentes se misturem.
• Cada operação permite configurar seus parâmetros no modo IA, variável ou estático, e um comportamento pós-execução (Continuar, Encerrar ou Pausar).

​

CRM do Inbox

• As permissões são administradas por grupo (dados do contato / etiquetas) com leitura e escrita separadas. Você pode restringir quais etiquetas o agente pode acessar.
• Requer pelo menos um canal conectado para que existam contatos sobre os quais operar.

​

$context

• Na lista de ferramentas aparece como $context para distingui-la da aba Contexto.
• As variáveis escritas ficam disponíveis para nodos posteriores do fluxo, por exemplo, {{$context.minha_variavel}}.

​

Informações de plataforma

• As três fontes são somente leitura; o agente não pode modificá-las.
• São injetadas como blocos de contexto, portanto não contam como uma invocação de ferramenta.

​

Bancos de dados

• O agente só pode operar sobre coleções da mesma empresa que você habilitar explicitamente no popover Configurar.
• As operações de escrita persistem imediatamente.
• O comportamento pós-execução (Continuar, Encerrar ou Pausar) é configurado por operação.

​

AI Routing

“Você atende apenas dúvidas de faturamento: extratos, datas de pagamento e detalhamento de cobranças.”

{
  "mode": "evaluate",
  "message": "quero relatar um problema com meu pedido"
}

{
  "mode": "direct",
  "target": "Suporte"
}

{
  "mode": "search"
}

• Um encaminhamento bem-sucedido encerra o turno do agente: a resposta ao usuário vem do workflow de destino. O agente não deve responder também.
• Se nada corresponder ou o encaminhamento falhar, o agente continua responsável pela conversa e deve seguir atendendo o usuário.
• Requer que o projeto tenha AI Routing habilitado e workflows com nome e descrição configurados. O comportamento pós-execução é fixo: o encaminhamento sempre encerra o turno do agente.
• O agente só pode encaminhar para workflows do mesmo projeto.

​

Documentos de conhecimento: busca por arquivo

• Detecta quando a pergunta se refere a um documento e busca só nesse documento.
• Busca em todos os documentos do agente, não só nos do primeiro projeto.
• Responde ancorada nos documentos: se não encontra nada relevante, diz isso.

​

Como o documento é detectado

• Maiúsculas, acentos, hífens e a extensão são ignorados, e pequenos erros de digitação são tolerados: “tarifario 2026”, “TARIFARIO” e “Tarifario_2026.pdf” encontram o mesmo arquivo.
• Um documento é detectado quando a pergunta inclui seu nome completo ou o menciona depois de uma palavra como “en”, “según”, “busca”, “revisa”, “consulta”, “dice”, “documento” ou “archivo”. As palavras-guia são reconhecidas em espanhol, o idioma da maioria dos agentes.
• Palavras genéricas como “manual”, “guia”, “política” ou “documento” não bastam sozinhas para escolher um arquivo.

​

Respostas ancoradas nos documentos