API da NexTags
Gere a chave de API da conta e use a API da NexTags para criar contatos, mandar fluxos, aplicar etiquetas e preencher campos a partir do seu sistema.
A API da NexTags deixa o seu sistema, ou um integrador como o Make, o n8n e o Zapier, trabalhar com a conta: criar e achar contatos, mandar fluxos e mensagens, aplicar etiquetas, preencher campos e mover oportunidades nos pipelines. Cada chamada leva a chave de API da conta no cabeçalho X-ACCESS-TOKEN. A referência completa, endpoint por endpoint, fica na central de desenvolvedores.
O que dá para fazer
- Criar contatos e achar um contato pelo e-mail ou pelo telefone. Veja Criar ou atualizar um contato.
- Mandar um fluxo, um texto ou um arquivo para um contato. Veja Enviar um fluxo para um contato.
- Aplicar etiquetas e preencher campos. Veja Etiquetar contatos e preencher campos.
- Criar e mover oportunidades nos pipelines. Veja Criar e mover oportunidades no pipeline.
Como conectar
Passo 1: Gere a chave
No pé do menu, clique em Configurações e abra a aba Integrações (1). Clique em Chave de API do NexTags (2), o primeiro cartão, e depois em Gerar (3).
- A aba Integrações.
- O cartão Chave de API do NexTags.
- Gerar: cria a chave da conta.
- Saber Mais: abre a documentação da API.
Passo 2: Copie a chave
A chave aparece no campo, e o cartão ganha o selo Ativa. Clique no campo, selecione a chave inteira e copie.
- A chave da conta.
- Excluir: apaga a chave na hora, sem perguntar.
Guarde a chave
Quem tem a chave acessa a conta pela API. Não publique a chave nem mande por mensagem aberta.
Passo 3: Faça a primeira chamada
O endereço base da API é https://app.nextagsai.com.br/api. Para conferir a chave, consulte os dados da conta, com a chave no cabeçalho X-ACCESS-TOKEN:
curl https://app.nextagsai.com.br/api/accounts/me \
-H "X-ACCESS-TOKEN: SUA_CHAVE"A resposta traz o nome e os dados da conta. Veja Sua primeira requisição e Consultar a conta.
O passo a passo completo da chave está em Gerar a chave de API. Para começar na central de desenvolvedores, veja Visão geral da API e Autenticação com a chave de API.
Se não funcionou
A API diz que a chave é inválida
Copie a chave inteira, sem espaços no começo ou no fim, e mande no cabeçalho X-ACCESS-TOKEN. Se a chave foi excluída e gerada de novo, use a nova.
Não vejo a aba Integrações
Só quem é Super Administrador abre as Configurações. Peça a um Super Administrador para gerar a chave. Veja Onde encontro a chave de API?.
Preciso de algo que a API não faz
Combine a API com os webhooks: o webhook de entrada recebe dados e inicia fluxos, e o webhook de saída avisa o seu sistema dos eventos da conta. Veja Webhooks.
Faça com a IA
Copie o pedido e cole no ChatGPT ou no Claude.
Quero ligar o meu sistema à NexTags pela API. Leia esta página: https://help.nextags.com.br/integracoes/api.md
O meu sistema: [descreva, por exemplo: uma loja que precisa criar o contato e mandar um fluxo de boas-vindas a cada venda]. Escreva os exemplos de chamada, com a chave no cabeçalho X-ACCESS-TOKEN, sem que eu precise colar a minha chave aqui.
Relacionados
Este conteúdo ajudou?
Obrigado! Sua resposta ajuda a melhorar a central.