NN Agent
Resumen

Cómo conectar la cuenta del mensajero a través de la API

La conexión de la cuenta al NN Agent a través de la API se realiza a través de una sesión de autorización: abres una sesión, el mensajero envía un código al número, y devuelves el código a la sesión. Con la protección de dos factores activada, se añade un paso más: la contraseña en la nube.

Antes de comenzar, obtén un token bearer, consulta Autenticación.

1
Abre una sesión de autorización
curl -X POST https://api.nexifyneo.com/v2/accounts/auth-sessions \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d 'YOUR_JSON_BODY'

En la respuesta, se devolverá un identificador de sesión en formato UUID. Todos los siguientes pasos se dirigen a él, y no al identificador de la cuenta: la cuenta aún no existe.

Una alternativa para iniciar sesión mediante un código QR en lugar del código del mensaje es POST /v2/accounts/auth-sessions/qr.

2
Espera a que el mensajero envíe el código

Consulta el estado de la sesión hasta que pase a esperar el código:

curl https://api.nexifyneo.com/v2/accounts/auth-sessions/AUTH_ID \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Si no recibiste el código, solicita un reenvío: POST /v2/accounts/auth-sessions/{auth_id}/resend-code.

3
Envía el código de confirmación
curl -X POST https://api.nexifyneo.com/v2/accounts/auth-sessions/AUTH_ID/code \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d 'YOUR_JSON_BODY'

Después de esto, verifica nuevamente el estado de la sesión: o se completará con éxito, o solicitará la contraseña en la nube.

4
Envía la contraseña en la nube si la protección de dos factores está activada
curl -X POST https://api.nexifyneo.com/v2/accounts/auth-sessions/AUTH_ID/password \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d 'YOUR_JSON_BODY'

Este paso es necesario solo para cuentas con protección de dos factores. Sin ella, la sesión se completa inmediatamente después del código.

5
Asegúrate de que la cuenta haya aparecido
curl https://api.nexifyneo.com/v2/accounts \
  -H "Authorization: Bearer YOUR_API_TOKEN"

La nueva cuenta está presente en la lista con su UUID. Este UUID se utiliza posteriormente para diálogos y para vinculación a campañas.

Si algo salió mal#

  • Una sesión no finalizada se puede interrumpir: DELETE /v2/accounts/auth-sessions/{auth_id}.
  • La respuesta 401 significa un problema con el token, no con la cuenta — ver Autenticación.
  • La interrupción en la verificación del certificado TLS no está relacionada ni con el token ni con la sesión: api.nexifyneo.com devuelve un certificado autofirmado, ver Limitaciones conocidas.

Qué cuentas conectar#

Para salidas, conecte cuentas separadas, no personales. La decisión de bloqueo la toma la plataforma, y al perder una cuenta, la correspondencia y los contactos permanecen en NN Agent — usted continuará con otra. Análisis en preguntas frecuentes.

Siguiente#

Updated

Desarrollado por Docsbook
Cómo conectar la cuenta del mensajero a través de la API — NN Agent