Autenticación

Todas las rutas /v1/instances/{instanceId}/... exigen el token de la instancia en el encabezado Authorization:

Authorization: Bearer TOKEN

El {instanceId} de la URL debe ser el de la instancia a la que pertenece el token. Con el token de una instancia no se accede a otra.

Token de seguridad de la cuenta (opcional)

Si su cuenta tiene un token de seguridad, envíelo también, en el encabezado x-account-token:

Authorization: Bearer TOKEN
x-account-token: TOKEN_DE_SEGURANCA

Usted activa y desactiva este token en el panel, en Segurança (el panel está en portugués).

Lista de IP autorizadas (opcional)

Si la cuenta tiene una lista de IP autorizadas, las llamadas deben provenir de una de ellas. Desde otra dirección, la API responde 403 con ip_not_allowed. La lista también está en Segurança, en el panel.

Cambiar el token

Si el token se filtra, genere otro. El anterior deja de valer de inmediato. Puede hacerlo en el panel o por la API:

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

La respuesta es { "token": "..." }. El nuevo valor aparece solo en esta respuesta. Guárdelo en un lugar seguro y actualice sus sistemas.

Precaución

Nunca ponga el token en código que se ejecuta en el navegador o en la aplicación del cliente final. Haga las llamadas desde su servidor.

Errores de autenticación

Estado	Código	Cuándo ocurre
401	invalid_token	Token de la instancia ausente, inválido o de otra instancia
401	invalid_account_token	La cuenta tiene token de seguridad y el x-account-token está ausente o es incorrecto
403	ip_not_allowed	La IP de la llamada no está en la lista de la cuenta
403	account_blocked	La cuenta fue bloqueada; hable con soporte (en portugués)
429	rate_limited	Demasiados fallos de autenticación seguidos desde la misma IP (vea Límites y errores)

Además, las rutas que usan la conexión con WhatsApp (conectar, enviar mensajes, verificar contactos) responden 402 con instance_suspended cuando la instancia está suspendida o con pago pendiente.