[Groner Agentes] Como ligar o agente às suas APIs com as Ações Customizadas
Uma Ação Customizada conecta o agente a um sistema seu: um ERP, um webhook ou qualquer serviço HTTP. O agente chama a ação como uma ferramenta durante a conversa, e você define como a resposta é tratada antes de chegar a ele, para que ele receba um texto limpo em vez de dados crus.
Antes de começar
As ações são criadas no nível da conta, podem ser usadas por vários agentes e são restritas a administradores.
Passo a passo
- Em Ações Customizadas, clique em Nova ação e informe o nome e a descrição.
- Configure as seções:
- Requisição: método (GET, POST…), URL, parâmetros que o agente coleta, cabeçalhos, corpo, autenticação e tempo limite. Use variáveis como
{{params.cidade}}(o que o agente coletou),{{lead.telefone}}e{{projeto.id}}(dados do CRM) e{{secret.TOKEN}}(segredos guardados com segurança). - Resposta tratada: quando a chamada deu certo, quais campos extrair (por JSONPath, como
$.data.status) e o texto que o agente recebe, inclusive quando a resposta vem vazia ou com erro. - Segurança & Governança: os domínios permitidos (obrigatório para ativar: a ação só chama esses endereços) e os segredos cifrados, que nunca são mostrados ao agente.
- Requisição: método (GET, POST…), URL, parâmetros que o agente coleta, cabeçalhos, corpo, autenticação e tempo limite. Use variáveis como
- Clique em Testar chamada e rode a ação com valores de teste e compare a requisição, a resposta crua e a resposta tratada.
- Ative a ação.
- Libere a ação em cada agente, na seção Ações.
Enquanto inativa, a ação fica como rascunho e não entra no agente.
Biblioteca de Ações
Em Biblioteca de Ações, você publica uma ação sua como modelo, só para a sua empresa ou para toda a Groner, e importa ações prontas com um clique. O modelo nunca leva os segredos e entra como rascunho inativo: quem importa revisa, preenche os próprios segredos e ativa.
Veja também
- [Groner Agentes] Como ensinar o seu negócio ao agente e escolher o que ele pode fazer no CRM
- O que é um Webhook?
- [Groner Agentes] Como funcionam os créditos e onde acompanhar o consumo dos agentes
- IA, automação e bot: qual é a diferença e quando usar cada um
Atualizado em: 08/10/2026
Obrigado!