Abrir NextChat
Comece aqui

Primeiros passos

Gere sua chave e faça a primeira chamada em poucos minutos.

Nesta página

Gerar a chave

  1. Abra as integrações

    Entre como proprietário ou administrador e abra Configurações → Integrações → Gerenciar API. Crie uma nova chave.

  2. Escolha permissões e validade

    Libere só o que a integração precisa: por exemplo, conversations:read e messages:send para avisar clientes. Quadros só são pedidos quando a chave tem permissões do Kanban. Validade de 7, 30 ou 90 dias, ou Para sempre.

  3. Copie e guarde

    O segredo (nck_…) aparece uma vez só. Guarde num cofre de senhas ou numa variável de ambiente.

Crie a chave com a conta certa

A chave age como a pessoa que a criou e enxerga o que ela enxerga, inclusive o número privado dela. Para integrar sistemas, crie a chave com uma conta de administrador sem número privado. Não coloque a chave no código-fonte nem em páginas abertas no navegador; se vazar, revogue e gere outra.

Primeira chamada

Confira se a chave funciona consultando /me. A resposta traz o nome da integração, as permissões e a validade.

Terminal · conferir conexãobash
export NEXTCHAT_API="https://app.nextchat.nextsistem.dev.br/api/integrations/v1"
export NEXTCHAT_API_KEY="SUA_CHAVE_API"

curl "$NEXTCHAT_API/me" \
  -H "Authorization: Bearer $NEXTCHAT_API_KEY"

Enviar a primeira mensagem

Pegue o número de WhatsApp em /channels, abra a conversa com o telefone do cliente e envie o texto. O client_id é um UUID escolhido por você: repetir a mesma chamada não envia duas vezes.

POST/conversationsbash
curl -X POST "$NEXTCHAT_API/conversations" \
  -H "Authorization: Bearer $NEXTCHAT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"channel_id":"ID_DO_NUMERO","phone":"5544999990000","name":"Maria Souza"}'
POST/conversations/{id}/messagesbash
curl -X POST "$NEXTCHAT_API/conversations/ID_DA_CONVERSA/messages" \
  -H "Authorization: Bearer $NEXTCHAT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"client_id":"3f1c1e0e-5c1a-4a52-9a43-8f9a1a1b2c3d","text":"Olá, Maria! Seu pedido saiu para entrega."}'

A mensagem sai de verdade pelo WhatsApp e aparece no NextChat para a equipe. Veja mais em Mensagens.

↑ ↓ navegar↵ abrirEsc fechar