Migración de la API de WhatsApp

Esta guía explica cómo conectar a Quoting24 un número que ya está activo en las API oficiales de WhatsApp (WhatsApp Business Platform) con otro proveedor, sin cambiar el número.

La sección WhatsApp es visible solo para los administradores.

La conexión empieza siempre en el mismo punto de Quoting24: Configuración → WhatsApp → WhatsApp Business → Conectar. El botón Conectar abre el registro integrado de Meta (Embedded Signup). A partir de ahí, Quoting24 es el proveedor que recibe y envía los mensajes de ese número. La modalidad prevista es la conexión a las API oficiales, descrita en Vista general de WhatsApp.

Qué procedimiento seguir

Meta tiene dos formas de conectar un número que ya usa otro proveedor. Antes de pulsar Conectar, comprueba el portfolio en Meta Business Suite → Configuración → Cuentas.

Lo que ves en Meta Business Suite	Qué hacer
Cuentas de WhatsApp y Cuentas de mensajería (Messaging Accounts) por separado	Modelo actual: comparte la cuenta de WhatsApp con Quoting24. El número se queda donde está.
Solo Cuentas de WhatsApp	Modelo anterior: migra el número con un código SMS o de voz.

En el modelo actual, Meta rechaza mover el número de una cuenta a otra. Desconectarlo del proveedor anterior no lo libera.

Qué preparar

Acceso de administrador a Quoting24.
Acceso de administrador al portfolio de Meta (Business Manager) que posee el número, con el usuario de Facebook que usarás en la ventana de Conectar.
El número ya registrado en las API oficiales. Los números de prueba gratuitos asignados por Meta no se pueden migrar.
Posibilidad de recibir un SMS o una llamada de voz en ese número, si Meta pide un código.

La migración del modelo anterior exige también:

nombre para mostrar ya aprobado, sin una solicitud de cambio de nombre todavía abierta;
verificación en dos pasos (PIN) desactivada en el número, sin borrar el número ni cerrar la cuenta. Si no tienes acceso a la cuenta de WhatsApp, pide la desactivación al proveedor actual.

Modelo actual: comparte el número con Quoting24

Usa este procedimiento si en Meta Business Suite aparecen tanto Cuentas de WhatsApp como Cuentas de mensajería.

Deja el número activo en el proveedor actual hasta el final. Quitarlo antes, con mensajes de clientes en curso, interrumpe la recepción.

En Quoting24 abre Configuración → WhatsApp.
En la fila WhatsApp Business pulsa Conectar e inicia sesión con el administrador del portfolio de Meta.
Selecciona el número ya registrado en el otro proveedor. Meta lo muestra en la lista y no pide un código nuevo: el número ya está registrado.
Meta propone el portfolio y la cuenta de WhatsApp de ese número. Confirma la compartición con Quoting24.
Introduce el nombre para mostrar del número y continúa. Meta puede revisarlo de nuevo después de la activación.
Revisa los permisos solicitados (cuenta de WhatsApp, cuenta de mensajería y recursos vinculados) y confirma.
Cierra la ventana de Meta. En Quoting24, la fila WhatsApp Business queda conectada.

Meta crea una cuenta de mensajería nueva para Quoting24, bajo la misma cuenta de WhatsApp. El proveedor anterior sigue conectado hasta que lo quites.

Hacer llegar los mensajes a Quoting24

Compartir la cuenta no mueve por sí solo los mensajes entrantes. Mientras el proveedor anterior siga siendo partner, Meta puede seguir entregándoselos.

Cuando en Quoting24 la fila WhatsApp Business está conectada:

En Meta Business Suite abre Configuración → Cuentas → Cuentas de mensajería, selecciona la cuenta, ve a Partners y quita el acceso de la app del proveedor anterior.
Abre Configuración → Cuentas → Cuentas de WhatsApp, selecciona la cuenta del número, ve a Partners y quita también ahí el acceso del mismo proveedor.
En la misma cuenta de WhatsApp abre Enrutamiento de conversaciones (Conversation routing) y asigna a Quoting24 cada tipo de conversación.

En la lista de partners puede aparecer el nombre de la app de Meta vinculada a Quoting24, no el texto «Quoting24». Si no está claro qué acceso quitar, detente y pregunta al soporte de Quoting24 antes de eliminar un partner.

Cuando queda un solo partner, Meta desactiva el enrutamiento y entrega los mensajes a ese partner.

Qué se conserva en este modelo

Se conservan en el número, porque la cuenta de WhatsApp no cambia:

número de teléfono
nombre para mostrar
calificación de calidad
límites de mensajería
estado de Official Business Account, si ya estaba activo

Las plantillas pertenecen a la cuenta de mensajería, no al número. La cuenta creada para Quoting24 nace vacía: las plantillas del proveedor anterior hay que volver a crearlas en Quoting24 y Meta debe aprobarlas de nuevo.

Hasta que estén aprobadas:

desde Quoting24 puedes responder con libertad solo dentro de las 24 horas desde el último mensaje del cliente;
en Broadcast API no hay modelos que seleccionar.

Los chats guardados en el software anterior no entran en los tickets de Quoting24. Los mensajes que llegan después de la conexión se convierten en tickets. Los chats que ya están en el teléfono del cliente siguen en la app de WhatsApp del cliente.

Modelo anterior: migra el número

Usa este procedimiento solo si en Meta Business Suite aparece únicamente Cuentas de WhatsApp.

Desactiva la verificación en dos pasos

Pide al proveedor actual que desactive el PIN del número, o hazlo tú desde el portfolio de Meta si tienes acceso.

El número y la cuenta deben seguir activos. Solo se quita la verificación en dos pasos.

Conecta el número desde Quoting24

En Quoting24 abre Configuración → WhatsApp.
En la fila WhatsApp Business pulsa Conectar e inicia sesión como administrador del portfolio de Meta.
Elige crear una nueva cuenta de WhatsApp. Es el paso con el que Meta mueve el número que ya existe: no es un segundo número.
Introduce el mismo nombre para mostrar ya aprobado en ese número.
Introduce el mismo número. Meta avisa de que ya está registrado en una cuenta de WhatsApp Business o en otro proveedor.
Pide el código por SMS o llamada de voz e introdúcelo.
Completa los pasos que quedan en la ventana de Meta.

El traslado suele terminar en pocos minutos. En Quoting24, la fila WhatsApp Business pasa a conectada. Durante el paso, la recepción puede interrumpirse unos minutos.

Qué se conserva y qué hay que rehacer

Se conservan en el número:

nombre para mostrar
calificación de calidad
estado de Official Business Account
límites de mensajería

Hay que rehacerlos en Quoting24:

las plantillas, que hay que volver a enviar y hacer aprobar por Meta antes de escribir fuera de la ventana de 24 horas y antes de usar Broadcast API;
las campañas del proveedor anterior;
el historial de chat de ese software, que no se importa. Los mensajes nuevos llegan como tickets.

Número ya en coexistencia con otro proveedor

Si el mismo número se usa a la vez desde la app WhatsApp Business y desde las API en otro proveedor, la conexión API no vuelve a enlazar por sí sola la app del teléfono.

Haz una copia de seguridad de los chats en la app WhatsApp Business.
Registra el mismo número en la app WhatsApp personal: el número sale de la app Business.
Regístralo de nuevo en la app WhatsApp Business.
En Quoting24 pulsa Conectar en WhatsApp Business y completa la coexistencia descrita en WhatsApp Coexistence: en la app, Configuración → Dispositivos vinculados → Vincular un dispositivo, y luego escanea el QR que muestra Quoting24.

Para llevar el número solo a las API, sin la app en el teléfono, usa el procedimiento del modelo de Meta que comprobaste arriba.

Después de la conexión

Los mensajes nuevos del número se convierten en tickets en Quoting24.
Fuera de las 24 horas desde el último mensaje del cliente se escribe con una plantilla aprobada. Las reglas del canal oficial están en Vista general de WhatsApp.
Las campañas se crean en Broadcast API cuando las plantillas están disponibles en Quoting24.
Para usar también la app WhatsApp Business en el mismo número hace falta WhatsApp Coexistence.
Los grupos y las listas broadcast de la app no pasan a las API.

Si el procedimiento se detiene

Meta rechaza el traslado del número. El portfolio está en el modelo actual: vuelve a la compartición y deja el número registrado en el proveedor anterior hasta que Quoting24 figure como conectado.
No llega el código SMS o de voz. En el modelo anterior, la verificación en dos pasos sigue activa. Desactívala y repite Conectar.
El nombre para mostrar bloquea la migración anterior. Meta acepta el paso solo con el nombre aprobado y sin un cambio de nombre pendiente.
Quoting24 está conectado pero los mensajes no llegan. En el modelo actual, el enrutamiento sigue apuntando al proveedor anterior. Revisa Partners y Enrutamiento de conversaciones antes de desconectar el número.
Si el partner que hay que quitar no se reconoce, contacta con el soporte de Quoting24 e indica el número y el ID del portfolio de Meta.