> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://ajuda.groner.app/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# [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

1. Em **Ações Customizadas**, clique em **Nova ação** e informe o nome e a descrição.
2. 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.
3. 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.
4. Ative a ação.
5. 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.

<!-- groner-suporte:veja-tambem:inicio -->

## Veja também

- [[Groner Agentes] Como ensinar o seu negócio ao agente e escolher o que ele pode fazer no CRM](https://ajuda.groner.app/pt-br/article/groner-agentes-como-ensinar-o-seu-negocio-ao-agente-e-escolher-o-que-ele-pode-fazer-no-crm-18e3kik/)
- [O que é um Webhook?](https://ajuda.groner.app/pt-br/article/o-que-e-um-webhook-1354sbg/)
- [[Groner Agentes] Como funcionam os créditos e onde acompanhar o consumo dos agentes](https://ajuda.groner.app/pt-br/article/groner-agentes-como-funcionam-os-creditos-e-onde-acompanhar-o-consumo-dos-agentes-1o7o849/)
- [IA, automação e bot: qual é a diferença e quando usar cada um](https://ajuda.groner.app/pt-br/article/ia-automacao-e-bot-qual-e-a-diferenca-e-quando-usar-cada-um-ouig9d/)

<!-- groner-suporte:veja-tambem:fim -->