El alta de WhatsApp pide el número primero: qué es Phone Number First
La guía de v4, leída el 18 de noviembre, dice que el número se carga antes de elegir la empresa. Waspy manda version v4, no la vista previa. El nombre en pantalla no está forzado.
Respuesta corta: si al conectar WhatsApp la ventana te pide el número antes de elegir la empresa, es el flujo Phone Number First. La guía de Embedded Signup v4, leída el 18 de noviembre de 2026, dice que el cliente carga y verifica el número al inicio, antes de crear o elegir el portfolio y la cuenta. La misma página dice que v4 y v4-public-preview sirven ese flujo. Waspy manda version: "v4". No manda la vista previa.
No es un error del código de verificación y no cambia lo que cobra Meta por mensaje.
Qué dice Meta, y desde cuándo
El changelog de la plataforma, leído el 18 de noviembre, tiene como última entrada el 15 de julio de 2026. Ahí Meta cuenta que Phone Number First, que ya estaba en las vistas previas públicas de v2, v3 y v4, empezaba a aparecer en el flujo por defecto para una parte de los negocios. En esa variante el número se verifica cerca del inicio, antes de crear o elegir los activos, para que un número que no sirve se vea antes.
La guía de v4, leída hoy, va más lejos que esa frase de julio: dice que Embedded Signup usa Phone Number First y que no hace falta la vista previa para verlo, porque v4 también lo sirve. No publica un porcentaje de cuentas. No lo invento.
El aviso de esa guía sigue en futuro: v2 y v3 “will be deprecated” el 15 de octubre de 2026. Esa fecha ya pasó. El texto no dice que un alta en v4 esté rechazada. El mismo desfase está en el código que no llega.
Qué manda Waspy
El extra del alta lleva version: "v4". No lleva v4-public-preview. No hay un campo del panel para “pedir el número primero”: si la ventana lo hace, es el flujo que Meta documenta para v4.
La pantalla del nombre visible es otra. La guía dice que v4-public-preview siempre la muestra, y que ese paso se está pasando a v4 más adelante. Waspy no cambia a la vista previa para forzarla. No le digas al equipo que el alta de hoy pide el nombre sí o sí.
La coexistencia —el mismo número en la app del celular y en la API— es un extra distinto: featureType: "whatsapp_business_app_onboarding". Sin eso, la guía de la vista previa dice que un número que ya está en la app se rechaza como no elegible. El camino está en coexistencia y en la guía de la app y la API.
Si el código no entra
En este flujo la verificación es una pantalla propia: SMS o llamada, y después el código. Si no llega, no es Phone Number First “roto” por definición. La tabla de Meta separa el número mal cargado, el que ya está registrado y el que pidió demasiados códigos. El detalle, con los números de error, está en la nota del 17.
No existe POST /api/v2/channels para saltarse la ventana. Cuando el alta termina, GET /api/v2/channels (scope channels:read) lista los números que quedaron. Si status no es active, un envío responde CHANNEL_NOT_CONNECTED.
Qué no cambia
El alta no se presupuesta como mensaje. Cuando el número ya escribe, sigue la rate card del 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. No hay una tarifa de 2027. El pendiente está en precios 2027.
El paso a paso del alta está en cómo obtener la API. Diez días sin tarjeta, en el registro. Los planes están en Planes.
