No me llega el código de WhatsApp Business: qué error es
Si no llega el código, el número suele estar mal, ya registrado o con demasiados intentos. Meta documenta 3441083, 3441084 y 3441082. Waspy abre ese alta en la versión v4.
Respuesta corta: si no llega el código al conectar WhatsApp Business, el error está en la ventana de Meta, no en un POST de la API de Waspy. La tabla de Embedded Signup, leída el 17 de noviembre de 2026, usa 3441083 cuando no sale el SMS, 3441084 cuando el número ya está en WhatsApp o en la app de empresa, y 3441082 o 3441101 cuando pediste demasiados códigos. Waspy abre ese alta en v4.
No existe POST /api/v2/channels para dar de alta el número. Cuando el alta termina, GET /api/v2/channels (scope channels:read) lista los que quedaron. El detalle de esa lista está en canales y calidad.
Los códigos que ves cuando el SMS no entra
| Código | Qué dice la tabla de Meta | Qué hacer |
|---|---|---|
| 3441083 | No pudo mandar el SMS. Revisá el número o pedí el código por llamada | El número tiene que poder recibir SMS o una llamada de voz. Un interno de empresa o un IVR no sirve |
| 3441085 | No pudo mandar el código. Esperá unos minutos | Reintentar después, no en el mismo segundo |
| 3441082 | Este número pidió demasiados códigos | Esperar el tiempo que muestra el mensaje y pedir uno nuevo |
| 3441101 | Pediste demasiados códigos | Igual: esperar. Un pedido durante la espera vuelve 2388367 |
| 3441084 | No puede mandar el código. Si ya está en WhatsApp o en la app de empresa, usá otro número | No es “esperar y listo”. Es otro número, o el flujo de coexistencia si querés el mismo |
| 2593037 | Falló el pedido del código | Reintentar. Si sigue, Business Support Home |
| 2593039 | Falló la verificación del código que tipeaste | El código venció o no coincide. Pedir otro cuando el límite lo permita |
| 3441051 | El número no es válido, o Meta rechazó el formato | Celular argentino: código de país 54, sin el 0 y sin el 15 |
La app del celular no es el mismo error
Waspy tiene dos entradas. El alta general fija version: "v4". La coexistencia —el mismo número en la app y en la API— agrega featureType: "whatsapp_business_app_onboarding". Esa pantalla reemplaza el selector de la cuenta por la de la app. Un número que ya figura conectado en WhatsApp Manager como Cloud API no aparece ahí. El comentario del código de Waspy dice que cargarlo a mano termina en el error #3441034. Ese número no está en la tabla de Meta leída el 17 de noviembre. El que sí está, para “este número ya está registrado”, es el 3441030: usar otro, o dar de baja el registro actual.
| Situación | Código que la tabla sí publica |
|---|---|
| Ya está registrado en la plataforma | 3441030 |
| Ya comparte la cuenta con otro partner | 2655093. Hay que desconectar a ese partner en la app |
| La app sigue vinculada a una plataforma | 3441049 o 2655094. En la app: Ajustes → Cuenta → Plataforma comercial → Desconectar, y esperar 15 minutos |
| La app todavía no lo marca como elegible para coexistencia | 3441045 o 3441077. Seguir usando la app y reintentar, o usar otro número |
| La app está desactualizada | 4563015 |
Qué hace Waspy con la versión
La página de errores, leída hoy, abre con este aviso: Embedded Signup v2 y v3, y sus vistas previas públicas, tenían fecha de baja el 15 de octubre de 2026. El texto sigue en futuro (“will be deprecated”) aunque esa fecha ya pasó. No dice que un alta en v4 esté rechazada. Waspy no manda v2 ni v3: el extra del flujo lleva version: "v4". Desde el 15 de octubre de 2026, Meta trata como v4 un extra sin versión o con una versión inválida. La v5, del 20 de octubre de 2026, prende la coexistencia por defecto y cambia el id de la cuenta en el mensaje de vuelta. Waspy no salta a ese contrato solo.
Si cerrás la ventana a la mitad, Meta manda al navegador un evento WA_EMBEDDED_SIGNUP con event: "CANCEL" y data.current_step. PHONE_NUMBER_VERIFICATION es la pantalla del código. PHONE_NUMBER_SETUP es la de cargar el número. Eso no es un mensaje de WhatsApp a tu cliente.
Después de que el código entra
El código no se cobra como mensaje de la Cloud API. Lo que sí se cobra es lo que mandás cuando el número ya está activo. En Argentina, desde el 1 de octubre de 2026: marketing ARS 89,56 (~US$0,0618), utilidad ARS 37,68 (~US$0,026), y servicio con 1.000 por número y por mes. La fuente es la rate card.
Si GET /api/v2/channels muestra el número y status no es active, un envío responde CHANNEL_NOT_CONNECTED. El alta se retoma en el panel: Canales → WhatsApp → Continuar con Facebook. Diez días sin tarjeta, en el registro. Cómo está armado el alta está en cómo obtener la API.
