Primeiros passos

Neste guia você cria uma instância, conecta o número e envia a primeira mensagem. Uma instância é um número de WhatsApp conectado à API.

Nos exemplos, troque INSTANCIA_ID pelo identificador da sua instância e TOKEN pelo token dela.

1. Crie a instância

No painel, abra Instâncias e clique em Nova instância. Copie o token: ele aparece uma única vez e dá acesso total à instância. Guarde-o em local seguro. Se perder, gere outro; o anterior deixa de valer.

O identificador (ID da instância) fica na aba de credenciais da instância, junto com o endereço base da API.

2. Inicie a conexão

curl -X POST https://api.zap.nigora.com.br/v1/instances/INSTANCIA_ID/connect \
  -H "Authorization: Bearer TOKEN"

A resposta é 202 com { "connectionStatus": "..." }. Ela só confirma que a conexão começou.

3. Leia o QR code

curl https://api.zap.nigora.com.br/v1/instances/INSTANCIA_ID/qr \
  -H "Authorization: Bearer TOKEN"

A resposta traz qr (o texto do código) e image (um PNG em data: URL, pronto para exibir). Enquanto o código não estiver disponível, os dois vêm como null: consulte de novo em alguns segundos.

No celular, abra o WhatsApp, vá em Aparelhos conectados e leia o código. Prefere digitar um código no lugar do QR? Veja Conexão.

4. Confirme a conexão

curl https://api.zap.nigora.com.br/v1/instances/INSTANCIA_ID \
  -H "Authorization: Bearer TOKEN"

A resposta traz connectionStatus (disconnected, connecting, qr ou connected) e, depois de conectada, o número em phone. Se preferir ser avisado, configure os webhooks instance.connected e instance.disconnected (veja Webhooks).

5. Envie a primeira mensagem

curl -X POST https://api.zap.nigora.com.br/v1/instances/INSTANCIA_ID/messages/text \
  -H "Authorization: Bearer TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "to": "5511999999999", "text": "Olá! Primeira mensagem pela API." }'

A resposta é 202 com { "id": "...", "status": "queued" }. Isso quer dizer que a mensagem entrou na fila, não que já foi entregue. Veja o resultado pelos webhooks, no guia Enviando mensagens.

Próximos passos

• Autenticação: proteja as chamadas com token de segurança e lista de IPs.
• Envio de mídia: imagem, vídeo, áudio e documento.
• Webhooks: receba as mensagens no seu sistema.