Cómo pasar de WhatsApp Business (la app) a la API sin perder tu número
Podés llevar a la API el mismo número que hoy usás en la app WhatsApp Business. Hay dos caminos: migrarlo (borrás la cuenta de la app y el número pasa entero a la API, sin el historial) o la coexistencia, que lo deja andando en la app y en la API a la vez, con algunos límites.
La app y la API: en qué se diferencian
La app WhatsApp Business es la aplicación gratuita que instalás en el celular: un teléfono, unos pocos dispositivos vinculados y una persona (o varias pasándose el aparato) contestando. La API de WhatsApp Business (la Cloud API de Meta) no tiene pantalla propia: es un servicio al que se conecta un sistema, y desde ese sistema atienden varias personas, responde un asistente y salen avisos automáticos.
| App WhatsApp Business | API de WhatsApp | |
|---|---|---|
| Costo de los mensajes | Gratis | Meta cobra las plantillas entregadas; responder dentro de las 24 h tiene un cupo gratis |
| Quién atiende | Un teléfono y sus dispositivos vinculados | Todo el equipo a la vez, cada uno con su usuario |
| Mensajes masivos | Listas de difusión que solo llegan a quien te tiene agendado | Campañas con plantillas aprobadas a contactos que aceptaron recibirlas |
| Automatización | Saludo, ausencia y respuestas rápidas | Chatbot, asistente con IA, avisos desde tu sistema y webhooks |
| Escribir primero a un cliente | Cuando quieras | Fuera de las 24 h, solo con plantillas aprobadas |
| Grupos y llamadas | Sí | No (la API es para chats uno a uno) |
La diferencia de fondo es esa última fila de reglas: en la API, si el cliente no te escribió en las últimas 24 horas, solo podés mandarle una plantilla aprobada por Meta. Lo explicamos en detalle en la guía de la ventana de 24 horas.
Cuándo conviene pasar a la API
La app alcanza mientras una sola persona contesta y el volumen se maneja a mano. Estas son las señales de que te quedó chica:
- Varias personas atienden el mismo número y se pisan, o nadie sabe quién respondió qué. En la API cada uno entra con su usuario a una bandeja compartida.
- Se te acumulan las mismas preguntas (horarios, precios, disponibilidad) y querés que las conteste un chatbot con IA a cualquier hora.
- Tu sistema tiene que avisar solo: confirmaciones de pedido, recordatorios de turno, códigos de verificación o cambios de estado.
- Mandás promociones y las listas de difusión no llegan porque la gente no te tiene agendado.
- Necesitás medir: cuántos mensajes se entregaron, cuántos se leyeron y cuánto tardó tu equipo en responder.
Si nada de esto te pasa, quedarte en la app es razonable: es gratis y simple. Si dudás por el costo, mirá cuánto cuesta la API de WhatsApp en Uruguay.
Qué necesitás antes de empezar
- El número: tiene que ser tuyo, con código de país y de área (no sirven los números cortos) y tiene que poder recibir un SMS o una llamada para el código de verificación. Puede ser un celular o un fijo.
- Una cuenta de Meta para la empresa (el portfolio comercial, antes Business Manager). Si tenés una página de Facebook de la empresa, probablemente ya exista; si no, se crea durante el alta.
- El nombre visible: el nombre que van a ver tus clientes. Meta lo revisa y tiene que corresponder a tu negocio; un nombre genérico o de otra marca se rechaza.
- Un medio de pago en la cuenta de WhatsApp de Meta: sin tarjeta cargada, Meta no deja salir las plantillas.
- La verificación del negocio (recomendada): no hace falta para empezar, pero sin ella arrancás con un límite de 250 personas por día a las que podés escribir primero y con 2 números como máximo.
Las dos formas de llevar tu número: migrar o coexistencia
Migrar es el camino clásico: borrás la cuenta de WhatsApp de la app en el celular y registrás ese mismo número en la API. El número, el nombre y los clientes que te escriben siguen siendo los mismos, pero el número deja de funcionar en la app. Meta lo dice sin vueltas: el historial de mensajes se pierde.
La coexistencia es la opción más nueva: conectás a la API el número que ya está en la app WhatsApp Business y seguís usando la app en el celular. Lo que contestás desde la app aparece en el sistema y viceversa. Para eso hace falta la app en la versión 2.24.17 o posterior y que el proveedor con el que te conectás ofrezca este tipo de alta.
| Migrar | Coexistencia | |
|---|---|---|
| La app en el celular | Deja de funcionar con ese número | Sigue funcionando |
| Historial | Se pierde | Se pueden sincronizar los chats individuales de los últimos 6 meses |
| Contactos | Quedan en tu teléfono, no en el sistema | Se sincronizan los que tienen WhatsApp |
| Grupos, llamadas y estados | No existen en la API | Siguen solo en la app |
| Listas de difusión | Se pierden | Quedan de solo lectura y no se pueden crear nuevas |
| Velocidad de envío | La normal de la API | Fija en 20 mensajes por segundo |
| Costo | Tarifa de la API | Lo que mandás desde la app sigue gratis; lo de la API, a tarifa |
La coexistencia tiene otras letras chicas: al conectarte se desvinculan los dispositivos vinculados (los volvés a vincular, salvo WhatsApp para Windows y relojes Wear OS), se apagan los mensajes temporales y los de ver una vez, y si el celular principal pasa unas dos semanas sin abrir la app, Meta desconecta el número de la API.
Paso a paso para migrar el número a la API
- Guardá lo que quieras conservar. Exportá los chats importantes desde cada conversación (Más opciones → Exportar chat) y anotá tus respuestas rápidas y tu mensaje de bienvenida. La copia de seguridad de Google Drive o iCloud no se puede cargar en la API.
- Avisá a tu equipo que durante unos minutos el número no va a estar en ningún lado, y elegí un momento de poco movimiento.
- Borrá la cuenta en la app: en WhatsApp Business, Configuración → Cuenta → Eliminar mi cuenta. Ojo: es eliminar la cuenta, no desinstalar la app.
- Esperá unos minutos. Meta dice que el número puede tardar hasta 3 minutos en quedar libre. Los mensajes que te manden en ese rato quedan en espera.
- Conectá el número en la API: desde la plataforma que vayas a usar, iniciás el alta de Meta, elegís o creás la cuenta de la empresa, cargás el nombre visible y el número, y ponés el código que te llega por SMS o llamada.
- Cargá el medio de pago en la cuenta de WhatsApp de Meta y creá tus primeras plantillas (la de bienvenida, la de confirmación, el recordatorio).
- Probá con tu propio celular: escribile al número, respondé desde el sistema y mandate una plantilla.
Con coexistencia los pasos 3 y 4 no existen: en el alta elegís conectar el número de la app, escaneás un código desde la app del celular y aceptás (o no) compartir el historial. Esa sincronización hay que hacerla dentro de las 24 horas siguientes al alta.
Qué pasa con el historial, los contactos y los grupos
- Tus clientes no notan nada raro: te siguen escribiendo al mismo número y ven el nombre de tu empresa. No hace falta avisarles.
- El historial: si migrás, las conversaciones anteriores no pasan a la API. Si usás coexistencia, se pueden traer los chats individuales de los últimos 6 meses; los archivos (fotos, audios) solo vienen si se mandaron en los últimos 14 días.
- Los contactos: en la API no hay agenda del teléfono; cada persona que te escribe queda como contacto en el sistema. Si tenés una lista, importala con el consentimiento de cada uno para poder mandarle promociones.
- Los grupos: la API no maneja grupos. Si los usás para coordinar con clientes, van a tener que seguir en otro número o en la app (con coexistencia).
- Volver atrás: un número migrado no puede volver a la app hasta que lo desconectes de la API.
Errores comunes al pasarse
- Desinstalar la app en vez de eliminar la cuenta. El número sigue tomado y el alta en la API falla.
- Borrar la cuenta sin exportar antes los chats que necesitás tener a mano.
- Usar un nombre visible que no coincide con tu marca: Meta lo rechaza y el número queda con envíos limitados hasta que lo corregís.
- No cargar el medio de pago: el chat anda, pero las plantillas no salen.
- Mandar una campaña el primer día: con el límite de 250 por día y una calidad todavía desconocida, un envío grande con quejas puede bajar la calificación del número. Empezá por avisos que la gente espera.
- Querer escribir texto libre a quien no te habló hace días: en la API eso requiere una plantilla aprobada.
Cómo se hace con BUZWIK
En BUZWIK conectás tu número desde el panel, en la sección WhatsApp, con el botón Conectar con WhatsApp: se abre la ventana oficial de Meta, elegís tu empresa, cargás el número y el código de verificación, y al volver el panel muestra cada paso del alta y te recuerda cargar el medio de pago en Meta. El número es tuyo y queda a nombre de tu empresa. Desde ahí atendés en la bandeja compartida, activás el asistente y conectás tu sistema por la API de WhatsApp.
Si tu número hoy está en la app, escribinos antes de conectarlo y vemos juntos si te conviene migrarlo o la coexistencia según cómo trabaja tu equipo. Podés crear tu cuenta y dejar todo listo mientras tanto.