WhatsApp Business

Del lado de WhatsApp está una cuenta de WhatsApp Business, que vive dentro de una cuenta comercial de Meta y contiene uno o más números de teléfono, un nombre visible del negocio verificado, una calificación de calidad por número y una biblioteca de plantillas de mensajes que Meta revisa y aprueba antes de que puedas usarlas. Detrás está la WhatsApp Business Platform, la vía oficial por API. Es distinta de la app de consumo y de la app WhatsApp Business del teléfono, y ninguna de las dos se puede conectar a un CRM.

Del lado de AppBO está la bandeja de entrada de conversaciones, junto a los canales de SMS, email y redes sociales, además de los flujos de trabajo que pueden enviar un mensaje, esperar una respuesta y ramificarse según ella. Una vez conectado, WhatsApp se vuelve un canal más en el registro del contacto: un recordatorio de cita que llega donde el cliente de verdad lee sus mensajes, una respuesta que cae en la misma bandeja de entrada compartida que todo lo demás y un historial de conversación que queda junto a las grabaciones de llamadas y el hilo de emails.

La razón para tratarlo distinto del SMS es que WhatsApp impone un modelo de consentimiento y mensajería en el software, no solo en sus políticas. Fuera de una ventana de conversación abierta solo puedes enviar plantillas aprobadas previamente, y solo a personas que dieron su consentimiento (opt-in). Dentro de la ventana puedes enviar libremente. Todo el diseño de una automatización de WhatsApp sale de esa única regla, y una integración armada como si WhatsApp fuera SMS no solo va a estar mal vista: la API la va a rechazar.

1. Confirma que tienes, o puedes crear, una cuenta comercial de Meta para el negocio, y que eres administrador en ella. Todo lo demás depende de ese acceso, y usar prestada la cuenta comercial de una agencia crea un problema de propiedad más adelante.
2. Completa la verificación del negocio de Meta. Pide documentos que prueben la entidad legal y su domicilio, y toma tiempo real. Empiézala antes que cualquier cosa que dependa de ella, porque la aprobación del nombre visible y los límites de mensajería más altos están condicionados a ella.
3. Elige el número de teléfono. Tiene que ser un número que controles y en el que puedas recibir un código de verificación, y no puede estar registrado en ese momento en la app de consumo de WhatsApp ni en la app WhatsApp Business. Si lo está, borra primero esa cuenta y acepta que su historial de chats se pierde.
4. Decide si el número es nuevo o una línea del negocio que ya existe. Usar una línea existente significa que los clientes pueden escribir a un número que ya conocen, pero también que ese número ya no se puede usar en las apps del teléfono.
5. En la subcuenta, abre el área de integraciones e inicia la conexión de WhatsApp. El flujo te pasa al registro integrado de Meta, donde eliges la cuenta comercial, creas o eliges la cuenta de WhatsApp Business y agregas el número de teléfono.
6. Verifica el número con el código que envía Meta y después configura el nombre visible. Meta revisa los nombres visibles contra su política de nombres, y un nombre que no coincide con el negocio verificado es un motivo de rechazo común.
7. Otorga los permisos que pide el cuadro de diálogo de Meta. Lee en el propio cuadro de diálogo los alcances exactos en lugar de suponerlos, y completa el flujo con un usuario que vaya a seguir siendo administrador.
8. Confirma la conexión en la plataforma: el número debe aparecer como conectado, con su calificación de calidad y su límite de mensajería visibles donde la plataforma los muestra.
9. Arma tus plantillas de mensajes y envíalas a aprobación. Cada plantilla tiene una categoría (marketing, utilidad o autenticación), y la categoría afecta lo que puede decir y cómo se trata. Escríbelas con variables para las partes que cambian y envía la redacción real que piensas usar.
10. Espera la aprobación de las plantillas y revisa el resultado. Una plantilla rechazada suele fallar por contenido promocional en la categoría de utilidad, por texto de relleno que quedó en una variable o por una redacción que suena a mensaje no solicitado. Corrige y vuelve a enviarla en lugar de buscarle la vuelta.
11. Arma el mecanismo de consentimiento. El consentimiento tiene que ser explícito y mencionar WhatsApp específicamente: una casilla en un formulario, un punto de entrada de clic a WhatsApp o una respuesta confirmada. Registra el consentimiento en el contacto con fecha, hora y origen.
12. Asocia el canal de WhatsApp de la plataforma con el campo de número de WhatsApp del contacto, y asegúrate de que los números se guarden en formato internacional completo, porque WhatsApp no acepta otra cosa.
13. Configura el lado entrante: a qué bandeja de entrada llega la conversación, a quién se le avisa y qué hace la plataforma con los mensajes multimedia.
14. Diseña los flujos de trabajo alrededor de la ventana de sesión. Usa una plantilla aprobada para abrir una conversación y deja las respuestas libres para el periodo después de que el cliente respondió. Arma una rama explícita para lo que pasa cuando no responde y la ventana se cierra.
15. Verifica el envío de plantillas salientes a un teléfono real que haya dado su consentimiento, revisando que las variables se vean bien y que el nombre visible aparezca tal como se aprobó.
16. Verifica el lado entrante: responde desde el teléfono, confirma que el mensaje aparece en la conversación de la plataforma asociado al contacto correcto y confirma que se activó la rama del flujo para cuando hay respuesta.
17. Prueba el camino de la baja: haz que el teléfono de prueba bloquee el número o pida que dejen de escribirle, confirma que la plataforma lo registra y que no se intentan más envíos de plantillas.
18. Anota quién tiene los derechos de administrador de la cuenta comercial, qué plantillas están aprobadas y el límite de mensajería actual del número, y después revisa la calificación de calidad cada cierto tiempo.

De la plataforma a WhatsApp

• Mensajes de plantilla: el nombre de la plantilla, su idioma y los valores de las variables que llenan sus espacios.
• Mensajes libres, permitidos solo mientras esté abierta una ventana de conversación iniciada por el cliente.
• Multimedia: imágenes, documentos, audio y video, sujetos a las reglas de tipo y tamaño de WhatsApp.
• Elementos interactivos donde la plantilla los define, como botones de respuesta rápida y enlaces de llamada a la acción.
• El número de destino en formato internacional completo y el identificador del número que envía.
• Confirmaciones de lectura e indicadores de escritura, donde la plataforma los expone.

De WhatsApp a la plataforma

• Mensajes entrantes de los clientes, con texto, multimedia y el identificador de WhatsApp del remitente, asociados a un contacto por número.
• El nombre de perfil de WhatsApp del cliente, que muchas veces no es el nombre que tiene en el CRM.
• Eventos de estado de los mensajes: enviado, entregado, leído, fallido, con un código de error cuando se rechaza un envío.
• Respuestas de botones de respuesta rápida, que llegan como mensajes sobre los que puedes ramificar.
• El estado de la ventana de conversación, de forma implícita: un mensaje del cliente abre la ventana.
• Avisos de aprobación y rechazo de plantillas, y cambios en la calificación de calidad del número.

Lo que no se mueve

• El historial de chats de la app de consumo o de la app de negocio del teléfono. Registrar el número para la API empieza con un historial vacío.
• Los grupos de WhatsApp. La API es para mensajería uno a uno entre negocio y cliente; no se puede participar en grupos.
• Los estados, las llamadas de voz y video, y las funciones de pagos de la app de consumo.
• Los mensajes libres fuera de la ventana de sesión. No se retrasan ni se ponen en cola: se rechazan.
• El consentimiento de otro canal. Un consentimiento por SMS no es un consentimiento para WhatsApp, y la plataforma no puede deducir uno a partir del otro.
• Las fotos de perfil de los contactos y el estado de bloqueo del lado de WhatsApp, más allá del error que recibes cuando falla un envío.
• Cambios al contenido de una plantilla sin una nueva aprobación. Editar una plantilla aprobada la regresa a revisión.

Escenario: un consultorio dental envía recordatorios de citas por WhatsApp, resuelve un cambio de cita dentro de la ventana abierta y maneja correctamente a quien no responde.

1. El consultorio completa la verificación del negocio de Meta, registra un número nuevo en la WhatsApp Business Platform y consigue que se apruebe el nombre visible, que coincide con el nombre legal del consultorio.
2. Se envían dos plantillas a aprobación: un recordatorio de utilidad con variables para el nombre del paciente, la fecha y la hora, y dos botones de respuesta rápida que dicen confirmar y reagendar; y una plantilla de marketing para la revisión anual.
3. Las dos se aprueban. El recordatorio se aprueba como utilidad; la revisión anual se aprueba como marketing, y el equipo toma nota de que va a tener un trato distinto y que los clientes la van a tolerar menos.
4. El formulario de reserva se actualiza con una casilla de consentimiento explícita que menciona WhatsApp y los tipos de mensaje que va a enviar el consultorio. La plataforma pone una etiqueta de consentimiento y la fecha y hora en cada contacto que la marca.
5. Una paciente agenda una cita con la higienista y da su consentimiento.
6. Dos días antes de la cita, un flujo de trabajo envía la plantilla de recordatorio de utilidad a su número de WhatsApp y llena las tres variables con los datos de la cita.
7. Ella toca el botón de reagendar. Su respuesta llega como un mensaje entrante, que abre la ventana de conversación y además activa la rama de reagendar del flujo.
8. Como ahora la ventana está abierta, la plataforma envía un mensaje libre con el enlace de reserva y una frase corta, sin necesitar una plantilla.
9. Ella responde preguntando si hay un horario más tarde un día específico. Alguien de recepción contesta desde la bandeja de entrada compartida, todavía dentro de la ventana, con texto de conversación normal.
10. Ella vuelve a agendar con el enlace. La cita nueva reemplaza a la anterior y el flujo de recordatorios se vuelve a programar para la nueva fecha.
11. Una segunda paciente recibe la misma plantilla de recordatorio y no responde nada. La ventana nunca se abre, así que la rama de sin respuesta del flujo no intenta un seguimiento con mensaje libre. Espera, y el día antes de la cita envía una segunda plantilla de utilidad aprobada y después crea una tarea de llamada.
12. Una tercera paciente responde pidiendo que no le vuelvan a escribir por WhatsApp. El equipo registra la baja en el contacto, lo que la saca del canal de WhatsApp y deja intacto su consentimiento de SMS y email.
13. Un mes después, el consultorio lanza la campaña de revisión anual con la plantilla de marketing, enviándola solo a contactos con registro de consentimiento para WhatsApp, por tandas, y vigilando la calificación de calidad del número entre una tanda y otra.
14. La calificación se mantiene en verde, así que la siguiente tanda sigue adelante; si hubiera bajado, el plan del equipo era pausar y pasar el resto de la campaña a email.

Límites de uso

Aplican dos topes distintos y es común confundirlos. Hay un límite de rendimiento de la API, y hay un límite de mensajería: un tope de cuántos clientes distintos puedes contactar para iniciar conversaciones en un periodo móvil, asignado por número y que sube por niveles a medida que envías tráfico de calidad. Un número nuevo empieza en un nivel bajo, así que una campaña de lanzamiento grande se va a detener a mitad del envío. La verificación del negocio y una buena calificación de calidad son lo que sube el nivel. Meta publica los niveles y umbrales vigentes en la documentación de la WhatsApp Business Platform. Consulta esas cifras ahí en lugar de planear con un número que recuerdas.

Reintentos e idempotencia

Los webhooks de estado se entregan al menos una vez y llegan desordenados, así que quien los procesa tiene que eliminar duplicados por el identificador del mensaje y nunca suponer que leído llega después de entregado en el orden en que se reciben. Los envíos salientes no tienen una clave de idempotencia universal, así que un envío que se reintenta después de un tiempo de espera ambiguo puede entregarse dos veces; protege los envíos de los flujos con una revisión de etiqueta o de campo en lugar de confiar en el transporte. Un envío de plantilla fallido no se debe reintentar a ciegas. Lee primero el código de error, porque un rechazo por política va a fallar igual cada vez.

Trampas al mapear campos

Las variables de las plantillas son posicionales y su tipo lo define la plantilla, así que mapear el campo equivocado produce una plantilla aprobada que dice algo absurdo, o un envío rechazado por una variable mal formada. Las variables no pueden tener saltos de línea ni ciertos formatos, y una variable vacía hace fallar el envío de inmediato, así que cada campo mapeado necesita un valor de respaldo. Los números tienen que ir en formato internacional completo, sin signos de puntuación. El nombre de perfil de WhatsApp del cliente no es su nombre real y no debe sobrescribir el campo de nombre del CRM. El idioma de la plantilla es parte de su identidad: enviar el nombre de plantilla correcto con el código de idioma equivocado falla.

Creación de duplicados

Los contactos duplicados aparecen cuando el número de WhatsApp de un cliente es distinto del celular que tienes registrado, algo común donde la gente tiene un número aparte para mensajería. Decide qué campo es el número de WhatsApp, guárdalo de forma explícita y combina los contactos por ese campo. Las conversaciones duplicadas aparecen cuando un negocio tiene dos números de WhatsApp y un cliente les escribe a los dos.

Pruebas contra producción

Meta ofrece un número de prueba para desarrollo que solo puede escribir a una lista corta de destinatarios verificados y no se puede usar para tráfico real. Sirve para probar la conexión y las plantillas, y no dice nada sobre la entrega a escala ni sobre la calificación de calidad. El nivel del límite de mensajería y la calificación de calidad solo existen en un número real, así que planea un lanzamiento por etapas en lugar de un cambio completo de golpe.

Vencimiento de la autenticación

La conexión depende de un token ligado a la cuenta comercial de Meta y al usuario que la autorizó. Quitarle a esa persona los derechos de administrador, cambiar la propiedad de la cuenta comercial, revocar la app en la configuración del negocio o una nueva verificación fallida pueden romperla. Meta también puede desconectar un número por violaciones de política, y una plantilla se puede desactivar o una calificación de calidad puede bajar con poco aviso. Vigila los envíos que fallan en masa, que indican un cambio a nivel de cuenta y no un problema de contenido, y mantén al menos dos administradores en la cuenta comercial.

Lo que se rompe con más frecuencia

• Mensajes libres que se intentan enviar fuera de la ventana de sesión, y que se rechazan. Es el error de diseño más común cuando un equipo trata WhatsApp como si fuera SMS.
• Un flujo que espera una respuesta y después intenta enviar un mensaje libre cuando la ventana ya se cerró, dejando una conversación a medias.
• Plantillas editadas después de su aprobación, lo que las regresa a revisión y rompe los flujos activos mientras tanto.
• Contenido de marketing enviado con una plantilla de categoría utilidad, lo que pone en riesgo la plantilla y el número.
• Un número que sigue registrado en la app WhatsApp Business del teléfono, lo que bloquea el registro en la API.
• La verificación del negocio sin completar, lo que deja el límite de mensajería en un nivel demasiado bajo para la campaña planeada.
• Un consentimiento recogido de forma genérica para mensajería en lugar de explícitamente para WhatsApp.
• Una calificación de calidad que baja después de un envío de marketing amplio, lo que reduce el límite de mensajería y afecta incluso a los recordatorios transaccionales.
• Una cuenta comercial de una agencia que contiene la cuenta de WhatsApp Business y que queda como rehén cuando termina la relación.