> ## 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).

# Como gerar um token de API para integrar o Groner com outros sistemas

O token de API é a chave que ferramentas como Zapier, Make, n8n ou um sistema próprio usam para conversar com o Groner: criar contatos e negócios, mover cards, registrar atividades e mais.

---

## Antes de começar

O token tem as **mesmas permissões do usuário** que o gerou. Por isso, recomendamos criar um usuário só para as integrações (por exemplo, "Integração Site"), com a função que ele realmente precisa. Assim fica fácil saber o que cada integração faz.

## Passo a passo

1. Entre no Groner com o usuário que vai ser dono do token.
2. Vá em **Configurações > Sistema & Desenvolvedor > Integrações** e abra a aba **Gerar token**.
3. Em **Dados de Autenticação**:
   - **Referência** é o identificador da sua conta, que algumas integrações pedem. Use o botão de copiar se precisar;
   - em **Senha**, digite a sua senha de acesso ao Groner.
4. Clique em **Gerar token**.
5. Copie o token que aparece em **Seu token de acesso** e guarde num lugar seguro.

> **Importante:** o token aparece uma única vez. Se você perder, gere outro. Gerar um token novo não cancela os anteriores.

## Como usar o token

Na ferramenta de integração, envie o token no cabeçalho de cada chamada:

`Authorization: Bearer SEU_TOKEN`

Os endereços e os exemplos de cada chamada estão na [Documentação da API Groner CRM](https://ajuda.groner.app/pt-br/article/documentacao-da-api-groner-crm-vz2bq2/).

## Validade e segurança

- O token vale por **500 dias**. Anote a data para gerar um novo antes de vencer.
- O token só funciona na sua conta do Groner.
- Trate o token como uma senha: não publique em sites, grupos ou planilhas compartilhadas.
- Depois de gerado, o token vale até vencer: trocar a senha ou desativar o usuário que o gerou não cancela um token que já foi gerado.

> **Dica:** em automações que rodam sozinhas (n8n, Zapier, Make), configure um aviso de erro. Se o token vencer ou o usuário for desativado, você fica sabendo na hora.

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

## Veja também

- [Documentação da API Groner CRM](https://ajuda.groner.app/pt-br/article/documentacao-da-api-groner-crm-vz2bq2/)
- [Como criar leads (novos negócios) e contatos pela API](https://ajuda.groner.app/pt-br/article/como-criar-leads-novos-negocios-e-contatos-pela-api-1eudxx5/)
- [Limites de requisições da API da Groner](https://ajuda.groner.app/pt-br/article/limites-de-requisicoes-da-api-da-groner-1cwtj65/)
- [Integração com o Zapier](https://ajuda.groner.app/pt-br/article/integracao-com-o-zapier-7zs2i8/)

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