Pular para o conteúdo
Acessar conta

Funções de IA: coletar dados e acionar fluxos

Crie uma função de IA para o agente coletar dados na conversa, guardar em campos, agendar e acionar um fluxo. Depois, ligue a função no agente.

TutorialAvançado5 min
Atualizado em 25/10/2026

Resposta rápida

No menu AI Hub, abra Ferramentas de IA › Funções de IA e clique em Adicionar Novo. Dê um nome, explique em O que este acionador faz? quando usar a função, ligue os dados aos campos e escolha o fluxo. Depois, marque a função nas Ferramentas de IA do agente.

Antes de começar

Função ou Ação de IA?

As Ações de IA fazem tarefas rápidas na conversa, como etiquetar ou transferir. A função coleta vários dados de uma vez, pode agendar e aciona um fluxo.

Passo a passo

Passo 1: Crie a função

No menu AI Hub, clique na aba Ferramentas de IA e em Funções de IA.

  1. Funções de IA: as funções que os agentes podem usar.
  2. Adicionar Novo: abre a janela da função.
  3. As funções da conta. Clique numa para editar. No menu ⋮ ficam Duplicar e Excluir.

Passo 2: Diga o que a função faz e que dados ela coleta

Na janela da função, preencha:

  1. Nome: até 64 caracteres. Use o formato do exemplo do campo, book_appointment: letras minúsculas, sem espaços, com sublinhado.
  2. O que este acionador faz?: quando a IA deve usar a função e para quê, em até 500 caracteres. O campo vazio sugere Permite ao usuário agendar um horário.
  3. Quais dados coletar?: à esquerda, o nome do dado (até 40 caracteres); à direita, o campo do contato que guarda o dado, como Endereço de e-mail. O × tira o dado.
  4. Adicionar Novo: mais um dado. A função aceita até 30.

Passo 3: Escolha o calendário, o fluxo e a mensagem

Mais abaixo, na mesma janela:

  1. Reserve no calendário: aparece quando um dado vai para um campo de data e hora e a conta tem calendário. À esquerda, o dado com o horário; à direita, o calendário. Veja Agendar pela conversa: fluxo, IA ou Caixa de Entrada.
  2. Qual fluxo é acionado: o fluxo que roda depois, ou Nenhum.
  3. Qual mensagem é emitida?: opcional, até 100 caracteres. O campo vazio sugere Você reservou um horário com sucesso.
  4. Continuar: salva a função.

Passo 4: Ligue a função no agente

Na aba Agentes de IA, clique no agente. No cartão Ferramentas de IA, clique na lista e marque a função.

  1. As funções aparecem com o tipo Function, à direita. As marcadas ganham ✓ e entram no campo, em cima.

Depois, clique em Salvar, no topo da tela.

Pronto: como conferir

  • Converse com o agente e peça o que a função faz, como marcar um horário. Veja Testar e ajustar o agente.
  • Na Caixa de Entrada, abra a conversa e confira no painel do contato os campos preenchidos.

Se não funcionou

A IA não usou a função

Deixe claro em O que este acionador faz? quando usar a função, com as palavras que o contato usa. Confira se a função está marcada nas Ferramentas de IA do agente que responde e se você clicou em Salvar.

Não aparece Reserve no calendário

Um dos dados precisa ir para um campo de data e hora, e a conta precisa ter um calendário. Veja Criar campos personalizados e Criar um calendário.

O campo ficou vazio

Dê ao dado um nome claro, que diga o que coletar, como email ou cidade, e confira se ele está ligado ao campo certo.

Faça com a IA

Copie o pedido e cole no ChatGPT ou no Claude.

Vou criar uma função de IA na NexTags. Leia este tutorial: https://help.nextags.com.br/tutoriais/ia/funcoes-do-agente.md

O que a função deve fazer: [descreva, por exemplo: registrar um pedido de orçamento]. Sugira o Nome no formato do exemplo, o texto de "O que este acionador faz?" (até 500 caracteres), a lista de dados para coletar com um nome claro para cada um e a mensagem de confirmação (até 100 caracteres).

Funções pela API

Para listar as funções a partir do seu sistema, use a API: Listar funções dos agentes.

Relacionados

Este conteúdo ajudou?

Obrigado! Sua resposta ajuda a melhorar a central.