El número existe

Verifica si un número de teléfono determinado existe en WhatsApp y puede recibir mensajes.

POST https://api.getincloud.ai/v1/verify/number

Verifica si un número de teléfono determinado existe en WhatsApp y puede recibir mensajes.

El formato del número debe ser E164, por ejemplo: +44692831121 o +182932001912

Puedes comprobar un número a la vez. Para comprobar varios números, puedes enviar varias solicitudes HTTPS a la API.

Según tu plan de suscripción, es posible que puedas comprobar de 2,000 a 50,000 números de teléfono al mes.

La comprobación del número se realiza en tiempo real, por lo que la sesión de tu número de WhatsApp debe estar en línea y sincronizada; de lo contrario, la API devolverá un error 503 - Not Available.

Nota importante: evita comprobar muchos números en un período corto de tiempo, ya que esto puede causar problemas o incluso el bloqueo de tu número de WhatsApp. Recomendamos no más de 30 comprobaciones de números por minuto, es decir, 1 comprobación cada 2 segundos.

Para validar el formato de un número de teléfono sin comprobar su existencia en WhatsApp, consulta el endpoint de la API [Numbers/Validate](#operation/validateNumbers).

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 la API con 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.

Cuerpo de la petición

Respuestas

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

// Validate if phone number exists in WhatsApp
curl --request POST \
  --url https://api.getincloud.ai/v1/verify/number \
  --header 'Content-Type: application/json' \
  --header 'Token: <api token goes here>' \
  --data '{"phone":"+1234567890"}'