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

​

Enviar mensagens interativas

• 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)

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

​

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.