Primeros pasos

En esta guía usted crea una instancia, conecta el número y envía el primer mensaje. Una instancia es un número de WhatsApp conectado a la API.

En los ejemplos, reemplace INSTANCIA_ID por el identificador de su instancia y TOKEN por el token de ella.

1. Cree la instancia

En el panel (que está en portugués), abra Instâncias y haga clic en Nova instância. Copie el token: aparece una sola vez y da acceso total a la instancia. Guárdelo en un lugar seguro. Si lo pierde, genere otro; el anterior deja de valer.

El identificador (ID de la instancia) está en la pestaña de credenciales de la instancia, junto con la dirección base de la API.

2. Inicie la conexión

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

La respuesta es 202 con { "connectionStatus": "..." }. Solo confirma que la conexión comenzó.

3. Lea el código QR

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

La respuesta trae qr (el texto del código) e image (un PNG en una URL data:, listo para mostrar). Mientras el código no esté disponible, ambos vienen como null: consulte de nuevo en unos segundos.

En el celular, abra WhatsApp, vaya a Dispositivos vinculados y escanee el código. ¿Prefiere ingresar un código en lugar del QR? Vea Conexión.

4. Confirme la conexión

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

La respuesta trae connectionStatus (disconnected, connecting, qr o connected) y, una vez conectada, el número en phone. Si prefiere que se le avise, configure los webhooks instance.connected e instance.disconnected (vea Webhooks).

5. Envíe el primer mensaje

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." }'

La respuesta es 202 con { "id": "...", "status": "queued" }. Eso significa que el mensaje entró en la cola, no que ya fue entregado. Vea el resultado mediante los webhooks, en la guía Envío de mensajes.

Próximos pasos

• Autenticación: proteja las llamadas con token de seguridad y lista de IP.
• Envío de multimedia: imagen, video, audio y documento.
• Webhooks: reciba los mensajes en su sistema.