Verificar el número por API

Ambos productos

Pendiente de revisión técnica

Los llamados de esta página siguen la documentación pública de la WhatsApp Cloud API, pero no se validaron todavía contra una implementación de Growtek. Antes de darla por cerrada, ingeniería tiene que confirmar la versión de la API y el flujo. No hay capturas: es un procedimiento por API.

Qué vas a lograr

Registrar el número en la Cloud API cuando el asistente de Meta no lo dejó listo, para que Número verificado pase en el diagnóstico de Growtek.

Antes de empezar

• Responsable: el equipo de Growtek. El registro del número es un paso interno; el cliente solo recibe el código en su celular.
• El identificador del número de teléfono (Agregar el número).
• El Access Token del usuario del sistema (Usuario del sistema y token).
• El cliente disponible con el celular de la línea durante el paso.

El token no se pega en chats ni tickets

Corré los llamados desde tu terminal. No pegues el token en WhatsApp, correo, tickets ni documentos compartidos.

Paso a paso

En los ejemplos, reemplazá vXX.X por la versión vigente de la Graph API, PHONE_NUMBER_ID por el identificador del número y ACCESS_TOKEN por el token.

1. Pedí el código. Usá SMS o VOICE según cómo lo vaya a recibir el cliente.

   curl -X POST "https://graph.facebook.com/vXX.X/PHONE_NUMBER_ID/request_code" \
     -H "Authorization: Bearer ACCESS_TOKEN" \
     -d "code_method=SMS" -d "language=es"

2. Pedile al cliente el código que le llegó y confirmalo.

   curl -X POST "https://graph.facebook.com/vXX.X/PHONE_NUMBER_ID/verify_code" \
     -H "Authorization: Bearer ACCESS_TOKEN" \
     -d "code=123456"

3. Registrá el número en la Cloud API con un PIN de 6 dígitos. Es el PIN de verificación en dos pasos del número: guardalo en el canal seguro del cliente.

   curl -X POST "https://graph.facebook.com/vXX.X/PHONE_NUMBER_ID/register" \
     -H "Authorization: Bearer ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"messaging_product":"whatsapp","pin":"PIN_DE_6_DIGITOS"}'

Cada llamado exitoso responde {"success":true}.

Cómo verificar que quedó bien

• En Meta, Números de teléfono muestra el número en estado Conectado.
• En Growtek, Diagnóstico del canal → Diagnosticar: Número verificado pasa.

Errores comunes

Síntoma	Causa	Solución
request_code responde error de permisos.	El token no tiene permisos sobre esa WABA.	Revisar los activos y permisos del usuario del sistema.
El código no llega.	La línea no recibe SMS o no tiene señal.	Repetir con code_method=VOICE.
register pide un PIN distinto.	El número ya tenía verificación en dos pasos con otro PIN.	Pedir el PIN al cliente o restablecerlo desde el administrador de WhatsApp.

Siguiente paso: Cargar el método de pago.