Cuentas en la API y sesiones de autorización
Cuenta — cuenta conectada del mensajero, en nombre de la cual NN Agent escribe y lee. La conexión se realiza a través de una sesión de autorización: abres una sesión, el mensajero envía un código, tú pasas el código a la sesión.
Todas las solicitudes requieren un token bearer, ver Autorización.
Sesiones de autorización#
/v2/accounts/auth-sessionsAbre una sesión de autorización por número de teléfono. Devuelve el identificador de la sesión, al que luego se vinculan el código y la contraseña. El cuerpo de la solicitud es JSON.
Enviado como el encabezado de Autorización. Tu clave es utilizada solo por tu navegador para esta solicitud — nunca se envía a Docsbook ni se almacena.
/v2/accounts/auth-sessions/qrAbre una sesión de autorización mediante un código QR — alternativa al código del mensaje. El cuerpo de la solicitud es JSON.
Enviado como el encabezado de Autorización. Tu clave es utilizada solo por tu navegador para esta solicitud — nunca se envía a Docsbook ni se almacena.
/v2/accounts/auth-sessions/{auth_id}Estado de la sesión: espera código, espera contraseña, completada, rechazada. Consulta esta operación entre los pasos de conexión.
Enviado como el encabezado de Autorización. Tu clave es utilizada solo por tu navegador para esta solicitud — nunca se envía a Docsbook ni se almacena.
UUID de la sesión de autorización
/v2/accounts/auth-sessions/{auth_id}/codeEnviar el código de confirmación que el mensajero envió al número. El cuerpo de la solicitud es JSON.
Enviado como el encabezado de Autorización. Tu clave es utilizada solo por tu navegador para esta solicitud — nunca se envía a Docsbook ni se almacena.
UUID de la sesión de autorización
/v2/accounts/auth-sessions/{auth_id}/passwordEnviar la contraseña en la nube si la cuenta tiene habilitada la autenticación de dos factores. El cuerpo de la solicitud es JSON.
Enviado como el encabezado de Autorización. Tu clave es utilizada solo por tu navegador para esta solicitud — nunca se envía a Docsbook ni se almacena.
UUID de la sesión de autorización
/v2/accounts/auth-sessions/{auth_id}/resend-codeSolicitar el reenvío del código de confirmación.
Enviado como el encabezado de Autorización. Tu clave es utilizada solo por tu navegador para esta solicitud — nunca se envía a Docsbook ni se almacena.
UUID de la sesión de autorización
/v2/accounts/auth-sessions/{auth_id}Interrumpir una sesión de autorización no finalizada.
Enviado como el encabezado de Autorización. Tu clave es utilizada solo por tu navegador para esta solicitud — nunca se envía a Docsbook ni se almacena.
UUID de la sesión de autorización
Desglose paso a paso de esta secuencia — Conectar cuenta a través de la API.
Cuentas#
/v2/accountsLista de cuentas conectadas del cliente. El cliente se identifica por el token.
Enviado como el encabezado de Autorización. Tu clave es utilizada solo por tu navegador para esta solicitud — nunca se envía a Docsbook ni se almacena.
/v2/accounts/{account_id}Tarjeta de una cuenta.
Enviado como el encabezado de Autorización. Tu clave es utilizada solo por tu navegador para esta solicitud — nunca se envía a Docsbook ni se almacena.
UUID de la cuenta
/v2/accounts/{account_id}/updateModificar los parámetros de la cuenta. El cuerpo de la solicitud es JSON.
Enviado como el encabezado de Autorización. Tu clave es utilizada solo por tu navegador para esta solicitud — nunca se envía a Docsbook ni se almacena.
UUID de la cuenta
/v2/accounts/{account_id}Desconectar la cuenta de NN Agent.
Enviado como el encabezado de Autorización. Tu clave es utilizada solo por tu navegador para esta solicitud — nunca se envía a Docsbook ni se almacena.
UUID de la cuenta
Vinculación de cuentas a la campaña#
Las cuentas por sí solas no envían nada: se vinculan a la campaña. Las operaciones de vinculación y desvinculación se describen en la página Campañas y contactos.
Siguiente#
- Conectar cuenta a través de API — orden de llamadas en su totalidad.
- Diálogos — qué leer y enviar después de la conexión.
- Multi-cuentas — la misma mecánica en el panel.
Updated
¿Fue útil esta página?