Solicitar código de emparejamiento

Solicita un código de autenticación para emparejar la sesión del número de WhatsApp mediante verificación por código, en lugar de usar el emparejamiento por código QR(operation/scanQR).

API de WhatsApp y CRM

Necesitas una clave de API. Pídela a nuestro equipo de soporte o créala desde la plataforma.

POST https://api.getincloud.ai/v1/devices/{deviceId}/authcode

Solicita un código de autenticación para emparejar la sesión del número de WhatsApp mediante verificación por código, [en lugar de usar el emparejamiento por código QR](#operation/scanQR).

Al solicitar el código de autenticación, el sistema enviará una solicitud de verificación a la aplicación móvil del número de WhatsApp, que el usuario debe aprobar y verificar ingresando el código de autenticación de 8 caracteres proporcionado.

Este es un método alternativo de emparejamiento de números que no requiere usar la cámara ni escanear un código QR para emparejar la sesión del número de WhatsApp con el sistema.

Nota: puedes especificar un número de teléfono al que enviar el código de emparejamiento indicándolo en el campo phone del payload JSON del POST. Si no se proporciona ningún teléfono, se usará por defecto el número de teléfono conectado previamente al dispositivo.

Si la sesión ya está autenticada, la API devolverá un error, a menos que especifiques el parámetro de consulta ?force=true, en cuyo caso la sesión anterior se cerrará y se creará una nueva.

Prueba este endpoint en el probador de API en vivo

>¿Necesitas ayuda? Explora todos los tutoriales, más de 100 ejemplos de casos de uso y prueba el probador de API en vivo con ejemplos de código listos para usar en más de 15 lenguajes de programación, incluidos JavaScript/Node.js, PHP, Python, C#, Java, Ruby, Swift, Kotlin, Powershell, cURL y más.

Autenticación

Envía tu API key en el encabezado Token en cada petición.

Parámetros

Campo	Dónde	Tipo	Obligatorio	Descripción
`force`	query	boolean	No	Si es `true`, fuerza la destrucción y el cierre de sesión de la sesión existente de WhatsApp, y solicita un nuevo código de autenticación. Esto hará que la sesión pase forzosamente a estar no autorizada (cierre de sesión) y requerirá un nuevo emparejamiento de la sesión del número. `default: False`

Cuerpo de la petición

Campo	Tipo	Obligatorio	Descripción
`phone`	string	No	Obligatorio si el dispositivo nunca se ha conectado. Número de teléfono al que enviar el código de autorización. El número de teléfono debe estar en formato E.164, por ejemplo: +16001234560 `minLength: 8` · `maxLength: 16`

Respuestas

Código	Descripción
`200`	Código de autenticación solicitado
`400`	Datos de consulta o del cuerpo de la solicitud no válidos
`401`	Acceso no autorizado por token de API no válido o vencido
`403`	Faltan los permisos requeridos o el número no se emparejó previamente mediante QR
`404`	Número no encontrado
`409`	Ya se está emparejando
`429`	Demasiadas solicitudes de escaneo
`500`	Error inesperado
`501`	No implementado
`503`	Servicio temporalmente no disponible. Inténtalo de nuevo más tarde

// This code example requires you to have installed curl package
// Installation instructions here: https://curl.haxx.se/download.html

// Request number auth code to a WhatsApp number
curl --request POST \
  --url https://api.getincloud.ai/v1/devices/{deviceId}/authcode \
  --header 'Token: <api token goes here>'

AnteriorSincronizar sesión SiguienteTransferir mensajes en cola

¿Te sirvió esta página?