Inicio WhatsApp | Conexión, plantillas y envío
💬

WhatsApp | Conexión, plantillas y envío

Conectar números, plantillas de Meta, tiers de envío y errores de entrega.
Manuela Farias
Por Manuela Farias and 9 otros
• 18 artículos

Guía Maestro — Cómo conectar tu número de WhatsApp a Cloud Chat

Esta guía existe para responder una única pregunta: 👉 "¿Cuál FAQ de WhatsApp debo leer antes de integrar mi número?" Antes de comenzar cualquier integración o migración, lee esta página. Evita pérdida de número, bloqueos, errores de configuración y retrabajo. 🧠 Visión general: hay 2 puntos importantes antes de conectar tu número La integración de WhatsApp con Cloud Chat implica los siguientes puntos principales: 1. Identificar si el número es nuevo o ya existente y, en base a ello, asegurar que todos los requisitos previos de Meta estén validados antes de iniciar la integración. 2. Elegir el modelo de integración (con o sin coexistencia). Cada escenario cuenta con una documentación específica. 📌 Primer paso: ¿Número nuevo o número existente? 🆕 Número nuevo Nunca ha sido usado en: - Aplicación de WhatsApp Business - Otro proveedor de tecnología (ejemplo: Cloud Chat) - Otra WABA en Meta ⚠️ La integración es un proceso delicado. Si se realiza incorrectamente, puede generar bloqueo o pérdida del número. 👉 Lee obligatoriamente antes de migrar: Requisitos previos obligatorios antes de conectar un número nuevo de WhatsApp 🔄 Número existente (migración) Ya ha sido usado en: - Aplicación de WhatsApp Business - Otro proveedor de tecnología (ejemplo: Cloud Chat) - Otra WABA en Meta ⚠️ La migración es un proceso delicado. Si se realiza incorrectamente, puede generar bloqueo o pérdida del número. 👉 Lee obligatoriamente antes de migrar: Requisitos previos obligatorios para migración de número WhatsApp 📥 Importación de historial de tickets (via API) en caso de migración Después de completar la migración, es posible importar tickets de otro sistema de ayuda mediante API de Cloud Chat. Esto es recomendable para empresas que: - Están migrando de otro sistema de atención - Quieren recuperar tickets antiguos para consulta, auditoría o continuidad operacional La importación se realiza mediante un endpoint específico de la API de Cloud Chat, enviando los datos estructurados de los tickets (contacto, fechas, mensajes e identificadores). 👉 Lee la documentación técnica completa con ejemplos de solicitudes y estructura obligatoria: Importación de historial de tickets 📌 Segundo paso: Elegir el modelo de integración — Con o sin coexistencia Antes de conectar, debes decidir cómo operará el número en el día a día de tu negocio. 🔒 Integración SIN coexistencia (API exclusiva) El número funciona exclusivamente via API oficial de Meta (WABA) dentro de Cloud Chat. Tras la conexión: - Todos los mensajes se envían y reciben solo a través de Cloud Chat (u otros sistemas conectados a la API) - Ya no será posible usar el número en la aplicación de WhatsApp Business. Ideal para empresas que: - Operan 100% vía help desk - Utilizan automatizaciones y chatbots - No necesitan usar WhatsApp en el teléfono celular - Buscan mayor estabilidad y control operacional 💡 Si aún necesitas usar el número en el celular, este no es el modelo ideal. 👉 Lee el paso a paso completo para realizar la integración: Cómo conectar un número de WhatsApp mediante API oficial (sin coexistencia) 🔁 Integración CON coexistencia (Móvil + API simultáneamente) El número funciona al mismo tiempo: - En la app de WhatsApp Business (móvil) - En la API oficial (WABA) vía Cloud Chat Esto permite mantener parte de la operación en el móvil mientras Cloud Chat opera en paralelo. 📥 Historial de mensajes Al realizar la integración con coexistencia, el historial de conversaciones de los últimos 6 meses se sincroniza e importa automáticamente en Cloud Chat. Esto permite continuidad en la atención, manteniendo el contexto de las conversaciones recientes ya realizadas en el móvil. ⚠️ Importante: hay una limitación técnica en esta sincronización — los archivos adjuntos (imágenes, videos, audios y documentos) no se importan a Cloud Chat. Solución alternativa: si necesitas acceder a archivos antiguos, debes consultarlos directamente en el teléfono, usando la propia app de WhatsApp Business. 📌 ¿Dónde aparece la coexistencia en el móvil? En la app de WhatsApp Business, en la sección de Dispositivos conectados. Cloud Chat aparecerá como un dispositivo adicional conectado vía API. ⚠️ ¿Qué pasa si alguien desconecta? Si alguien con acceso al móvil remueve manualmente el dispositivo conectado: - Cloud Chat dejará de recibir mensajes inmediatamente. - Será necesario volver a realizar todo el proceso de integración. ⚠️ Limitación importante de la coexistencia Los mensajes enviados desde aplicaciones no soportadas por Meta no se reflejan en Cloud Chat. Ejemplos de apps no soportadas: - WhatsApp Desktop (Windows) - WhatsApp en WearOS Estos mensajes siguen visibles en el teléfono principal, pero no generan webhook, por lo que no aparecen en Cloud Chat. 👉 Para entender en detalle por qué sucede esto, cómo diagnosticar y cuáles son las alternativas, ingresa a: ¿No aparecen mensajes en Cloud Chat? Entienda la limitación de la coexistencia Ideal para empresas que: - Aún necesitan operar desde el móvil - Tienen vendedores, consultores o gestores de cuentas usando la app móvil - Quieren automatizar la atención de forma gradual - Desean probar la API sin dejar de usar la app 👉 Lee el paso a paso completo para realizar la integración: Cómo conectar un número de WhatsApp con coexistencia (móvil + API) ❌ Errores comunes que esta guía ayuda a evitar - Iniciar la integración sin validar el estado de la WABA - No desactivar la Verificación en Dos Pasos antes de la migración - No entender la limitación de WhatsApp Desktop en coexistencia - Confundir número nuevo con número migrado - No validar la forma de pago cuando sea necesaria

Última actualización el Sep 01, 2026

Plantillas de WhatsApp: Reglas de Estructura, Categorización (Autenticación, Utilidad y Marketing) y Cómo Evitar Rechazos

📌 Este artículo trata sobre las reglas de Meta Esta guía explica las reglas oficiales de Meta que afectan la aprobación de plantillas: - Estructura (Encabezado, Cuerpo, Pie de página, Botones) - Uso correcto de variables (placeholders) - Diferencia entre Autenticación, Utilidad y Marketing - Principales motivos de rechazo - Lista de verificación para aumentar las probabilidades de aprobación Si deseas aprender cómo crear, editar o eliminar plantillas en Cloud Chat, accede a: Guía de Plantillas de WhatsApp en Cloud Chat: Creación, Edición y Aprobación 🧩 ¿Qué es una plantilla? Son mensajes preaprobados por Meta para envíos iniciados por la empresa (ej.: notificaciones, actualizaciones transaccionales, autenticación y campañas), normalmente utilizados cuando necesitas enviar un mensaje después de la ventana de 24h. Incluimos también referencias oficiales de la documentación de Meta sobre categorización de plantillas: https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-categorization 🧱 Estructura de una plantilla (componentes) Una plantilla está compuesta por hasta 4 bloques principales: Encabezado (Header), Cuerpo (Body), Pie de página (Footer) y Botones. 🧷 Header (opcional) Texto: hasta 60 caracteres y soporta 1 variable. Medios: puede configurarse como imagen, video o documento (detalles en “Adjuntos”). 📝 Body (obligatorio) Texto principal de la plantilla. Soporta variables. Límite: hasta 1024 caracteres. 🧾 Footer (opcional) Notas cortas (ej.: “No respondas a este mensaje”). Límite: hasta 60 caracteres. 🔘 Botones (opcional) Las plantillas pueden tener hasta 10 botones (dependiendo del tipo/categoría). ⚠️ Atención en la visualización: si hay más de 3 botones, WhatsApp puede mostrar solo algunos y agrupar el resto en “ver todas las opciones”. 🔢 Variables (placeholders): reglas que más causan rechazo Las variables permiten personalizar el contenido (ej.: nombre del cliente, número del ticket, estado). ✅ Reglas obligatorias (validación de Meta) 1. No puede comenzar ni terminar con variable Meta bloquea la creación cuando la plantilla empieza o termina con un placeholder. ✔ Correcto: Hola {{nombre}}, tu ticket {{ticket}} ha sido actualizado. ❌ Incorrecto: {{nombre}} tu ticket ha sido actualizado. Tu ticket fue actualizado: {{actualizacion}} 2. La variable no puede quedar “sola” (sin contexto) Evita plantillas que sean solo un placeholder (ej.: {{prueba}}) o con texto demasiado genérico. Esto aumenta mucho el riesgo de rechazo por baja calidad o uso ambiguo. 3. Patrón del nombre de la variable Debe estar entre {{ }} y no puede contener acentos ni espacios. Si necesitas separar palabras, usa guion bajo: ✔ {{mes_de_referencia}} ❌ {{mes de referencia}} 🧭 Categorías (según la documentación oficial de Meta) Al crear la plantilla eliges la categoría: Autenticación / Utilidad / Marketing. ⚠️ Sin embargo, Meta analiza el contenido + la intención del mensaje. Ella puede: - Reclasificar automáticamente - Rechazar la plantilla si la categoría no es compatible Documentación oficial: https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-categorization 🔐 Autenticación (Authentication) Usar para códigos de verificación (OTP) y flujos de autenticación. ✔ Debe contener: - Código de verificación - Información de expiración - Contexto de inicio de sesión o seguridad ❌ No puede contener: - Promoción - Oferta - Upsell Ejemplo correcto: Tu código de verificación es {{codigo}}. Caduca en {{tiempo}} minutos. 🧾 Utilidad (Transaccional / Utilidad) Según la documentación de Meta, Utility debe: - Estar relacionada con una acción previa del usuario - Ser operacional o informativa - No contener contenido promocional - No tener lenguaje persuasivo - No intentar generar una nueva conversión 🔎 Principales motivos de rechazo como Utility 1. Lenguaje vago ❌ “Tenemos novedades para ti” ❌ “Consulta esta actualización especial” 2. Lenguaje promocional disfrazado ❌ “Aprovecha tu próxima compra” ❌ “No pierdas esta oportunidad” 3. Falta de contexto transaccional Si no está claro qué acción realizó el usuario, Meta suele clasificarlo como Marketing. ✅ Buenas prácticas para aprobar como Utility ✔ Menciona claramente el contexto: - Pedido - Número de protocolo - Ticket - Cita/Programación - Firma - Pago - Entrega ✔ Incluye identificador claro: - Número del pedido - Número del ticket - Protocolo - ID de la transacción ✔ Usa lenguaje objetivo y neutral ✔ Enfócate en informar, no en persuadir ✔ Ejemplo correcto (Utility con mayor probabilidad de aprobación): Hola {{nombre}}! Tu pedido {{pedido_id}} ha sido enviado y está en camino. Previsión de entrega: {{fecha_entrega}}. ✔ Ejemplo correcto (Soporte): Hola {{nombre}}, tu ticket {{ticket}} ha sido actualizado: {{texto_actualizacion}}. Si necesitas añadir información adicional, responde por aquí. ❌ Ejemplo que puede ser reclasificado a Marketing: Hola {{nombre}}! Tu pedido está listo. ¡Aprovecha y revisa nuestras nuevas ofertas! 📣 Marketing Incluye: - Promociones - Ofertas - Cupones - Reactivación - Lanzamientos - Cross-sell / Upsell Regla práctica: Si el mensaje intenta generar una nueva venta o conversión → es Marketing. 📎 Adjuntos en la plantilla (Encabezado de medios) 🖼️ Imagen: JPEG o PNG hasta 2MB 🎞️ Video: MP4 o 3GP (H.264/AAC) hasta 2MB 📄 Documento: PDF hasta 2MB 🎬 GIF: tratado como MP4 (límite aproximado de 3,5MB; por encima puede volver video). ✅ Lista de verificación rápida antes de enviar - Cuerpo específico y contextual - Lenguaje neutro si es Utility - Identificador transaccional incluido - Sin términos promocionales (para Utility) - Texto del encabezado: máximo 60 caracteres y 1 variable - Verificar formato y tamaño del medio - Crear por idioma/locale - Validar placeholders (no comenzar/terminar con variable) ❓ Preguntas frecuentes ¿Por qué Meta cambió mi categoría? Porque la categorización se basa en contenido + intención. Si hay alguna indicación de promoción, persuasión o intento de conversión, el mensaje puede clasificarse como Marketing, incluso si seleccionaste Utility. ¿Mi plantilla fue rechazada como Utility? ¿Qué debo revisar primero? 1. Elimina cualquier tono comercial 2. Incluye un contexto claro de acción del usuario 3. Agrega un identificador transaccional 4. Haz que el texto sea más objetivo y menos genérico Para más detalles sobre cómo gestionar plantillas en Cloud Chat: https://cloudchat.cloudhumans.com/hc/cloud-chat/articles/1754505671-gestao-de-templates-whats_app

Última actualización el Feb 25, 2026

Plantillas de WhatsApp: crear, editar, eliminar y usar el constructor

Visión general El constructor de plantillas de WhatsApp de Cloud Chat ha añadido un nuevo formulario con vista previa en vivo, validación en tiempo real y panel para plantillas rechazadas por Meta. Ahora es posible armar mensajes con la gama completa de botones soportados por Meta — respuesta rápida, URL, teléfono y el nuevo Copy Code (cupón que el cliente copia con un clic). Las plantillas en revisión (estado PENDING) también son editables, y los archivos adjuntos de tipo documento ahora conservan el nombre del archivo en el destinatario. La idea es resolver los problemas más comunes de las plantillas sin necesidad de abrir el Meta Business Manager — especialmente útil para equipos que no tienen acceso al panel de Meta porque está gestionado por otra área de la empresa. :::info Este artículo cubre el uso del creador de plantillas dentro de Cloud Chat. Para entender las reglas oficiales de Meta sobre estructura, categorías y motivos de rechazo, ve a Reglas de plantillas de WhatsApp (Meta): categorías, estructura y rechazos. ::: ¿Qué son las plantillas de WhatsApp? Las plantillas son mensajes preaprobados por Meta que permiten a tu empresa iniciar conversaciones con clientes. Son necesarias para: - Enviar promociones y campañas - Confirmar pedidos y citas - Enviar códigos de verificación - Notificar sobre entregas Requisitos previos - Ser administrador de la cuenta en Cloud Chat - Tener una caja de entrada de WhatsApp ya configurada Dónde se encuentra Configuraciones → Cajas de entrada → seleccionar una bandeja de WhatsApp → pestaña Plantillas. Desde aquí puedes: - Crear una plantilla nueva - Editar plantillas PENDING (en revisión) y APPROVED (aprobadas) - Visualizar la razón de rechazo de plantillas REJECTED - Eliminar plantillas - Sincronizar manualmente el estado con Meta Cómo crear una plantilla Cómo usar el constructor de plantillas de WhatsApp en Cloud Chat 1. Haz clic en Agregar plantilla. 2. Completa las informaciones básicas (nombre, categoría, idioma). 3. Monta los componentes de la plantilla (cabecera, cuerpo, pie, botones) — todos opcionales, excepto el cuerpo. 4. Observa la vista previa en vivo al lado del formulario (o abajo en móvil) para ver cómo se mostrará la plantilla en WhatsApp. 5. Haz clic en Guardar. La plantilla es enviada a Meta y permanecerá en estado PENDING hasta ser revisada. :::info El botón Guardar estará deshabilitado hasta que todos los campos sean válidos. Si está en gris, desplaza el formulario para encontrar el campo con error destacado en rojo. ::: Información básica | Campo | Reglas | | --- | --- | | Nombre | Letras minúsculas, números y guiones bajos. Sin espacios ni acentos. | | Categoría | Marketing, Utilidad o Autenticación. | | Idioma | Idioma del contenido (ej.: Portugués (Brasil), English, Español). | La categoría afecta las reglas: las plantillas Autenticación no aceptan cabecera, pie, botones de URL ni Copy Code — sólo botones de respuesta rápida. :::info Patrón de nombre recomendado: categoria_propósito (ej.: pedido_confirmacion, promocion_black_friday). Evita acentos, espacios y mayúsculas — nombres como Promoción Black Friday no pasan la validación. ::: Cabecera (opcional) Tipo único por plantilla. Cuatro opciones: | Tipo | Lo que aparece | Límite | | --- | --- | --- | | Texto | Línea de texto en negrita encima del cuerpo | 60 caracteres, como máximo 1 variable | | Imagen | Imagen grande en la parte superior del mensaje | JPG o PNG, hasta 5 MB | | Vídeo | Vídeo reproducido en línea | MP4, hasta 16 MB | | Documento | Archivo adjunto (PDF, hoja de cálculo, etc.) con nombre visible | PDF, hasta 100 MB | Para medios (imagen, vídeo, documento), se realiza la subida del archivo de ejemplo — Meta usa ese archivo para revisar la plantilla. Al enviar una campaña, puedes reemplazarlo por el archivo final. :::success El nombre del archivo enviado se conserva en el destinatario en anexos del tipo Documento. ::: Cuerpo (obligatorio) El texto principal del mensaje. Acepta variables en formato {{...}} para personalización por destinatario. Dos formatos de variable: | Formato | Sintaxis | Uso recomendado | | --- | --- | --- | | Posicional | {{1}}, {{2}}, {{3}} | Plantillas simples, integraciones vía API por posición | | Nombrado | {{nombre_cliente}}, {{cupom}} | Plantillas con muchas variables, más legibles | El formato se detecta automáticamente por el contenido del cuerpo. No es permitido mezclar ambos en la misma plantilla. Reglas: - Máximo de 1024 caracteres - Variables en snake_case (letras minúsculas, números, guion bajo) - No puede comenzar o terminar con variable - Para cada variable, se debe ingresar un valor de ejemplo (usado por Meta en la revisión) Pie (opcional) Texto breve debajo del cuerpo, sin variables. - Límite de 60 caracteres - Útil para firmas, avisos legales o instrucciones como "Responde STOP para salir" Botones (opcional) Hasta 10 botones en total. Cuatro tipos disponibles: | Tipo | Lo que hace | | --- | --- | | Respuesta rápida | Envía un texto predefinido como respuesta al pulsar | | URL estática | Abre una URL fija | | Teléfono | Inicia una llamada al número configurado | | Copy Code | Copia un código (cupón, voucher) al portapapeles al pulsar | Límites por categoría: - Marketing / Utilidad: hasta 10 botones. Se pueden mezclar tipos. - Autenticación: sólo botones de respuesta rápida. Botón Copy Code Muestra un botón que, al pulsarlo, copia un código al portapapeles del destinatario. Ideal para cupones, vouchers, códigos promocionales. - Disponible para categorías Marketing y Utilidad - La versión actual usa código estático (el mismo código para todos los destinatarios) Vista previa en vivo Junto al formulario (o debajo en pantallas más pequeñas), aparece una simulación de cómo llegará la plantilla a WhatsApp: - Cabecera, cuerpo, pie y botones en el orden real - Variables con los valores de ejemplo rellenados - Se muestran las previsualizaciones de los archivos multimedia Estados de la plantilla Las plantillas aparecen en la lista con una insignia de color: | Estado | Color | Significado | | --- | --- | --- | | APPROVED | Verde | Aprobada por Meta — lista para usar | | PENDING | Amarillo | En revisión por Meta — puede usarse y editarse | | REJECTED | Rojo | Rechazada por Meta — abre la plantilla para ver la razón | | PAUSED | Gris | En pausa por Meta (generalmente por baja calidad de uso) | :::info La revisión de Meta generalmente tarda unos minutos, pero puede demorar hasta 24h en casos raros. Cloud Chat sincroniza el estado automáticamente. ::: Cuando una plantilla es rechazada Las plantillas REJECTED muestran un panel dedicado en la parte superior del modal de edición con: - Motivo del rechazo en pt-BR (traducido desde los códigos de Meta) - Llamado a la acción "Editar y reenviar" que abre el formulario para correcciones - Si el código de rechazo aún no está mapeado, muestra un fallback genérico con el código original :::info Para entender por qué Meta rechazó y cómo ajustar el contenido, consulta Reglas de plantillas de WhatsApp (Meta). ::: Flujo: 1. Abre la plantilla rechazada desde la lista. 2. Lee la razón en el panel rojo. 3. Haz clic en Editar y reenviar. 4. Ajusta el contenido según el motivo señalado. 5. Guarda — la plantilla volverá a PENDING y Meta revisará nuevamente. Editar plantillas en revisión (PENDING) Las plantillas en PENDING son editables. Al guardar, se reinicia la revisión de Meta. :::warning La insignia amarilla en el campo de estado recuerda: editar una plantilla en PENDING reinicia la revisión. Úsalo si detectas un error justo después de crear la plantilla. ::: Cómo eliminar una plantilla 1. Encuentra la plantilla en la lista. 2. Haz clic en Eliminar. 3. Escribe el nombre exacto de la plantilla para confirmar. 4. Haz clic en Sí, eliminar. :::error La eliminación no puede deshacerse — y Meta conserva el nombre de la plantilla por 30 días antes de eliminarla definitivamente. Durante ese período, no se puede crear otra plantilla con el mismo nombre. ::: Preguntas frecuentes ¿Puedo usar variables en cualquier parte de la plantilla? En el cuerpo, sí — siempre que no estén al inicio o al final. En la cabecera de texto, hasta 1 variable. El pie no acepta variables. ¿Puedo mezclar variables posicionales ({{1}}) y nombradas ({{nombre}}) en la misma plantilla? No. Cloud Chat detecta el formato por el contenido del cuerpo y fuerza la coherencia — lo que esté en el cuerpo debe también estar en los botones y en la cabecera. ¿Qué pasa si edito una plantilla aprobada? Vuelve a PENDING y se somete a una nueva revisión. Las campañas en uso siguen funcionando mientras se revisa. Meta limita las ediciones en plantillas aprobadas a 1 por día y 10 por mes — si se excede, el guardado falla hasta que se renueve la ventana. ¿El Copy Code permite diferentes códigos por destinatario? En esta versión, no — el código es estático y definido en la plantilla. Se planea soporte para código único por envío en una fase futura. ¿Por qué mi plantilla fue rechazada incluso si pasa la validación en Cloud Chat? La validación en Cloud Chat cubre las reglas estructurales de Meta (tamaños, formatos, sintaxis). Meta también aplica criterios de calidad del contenido (lenguaje promocional, formato, contexto) que solo se pueden evaluar en la revisión final. El panel de rechazo muestra el motivo específico. Para más detalles, consulta Reglas de plantillas de WhatsApp (Meta). ¿Puedo crear plantillas de Autenticación con botón Copy Code? No. Las plantillas de Autenticación solo aceptan botones de respuesta rápida. Para enviar códigos OTP, considera usar la categoría Utilidad. Errores comunes "Nombre ya existe" Ya hay una plantilla con ese nombre — incluso nombres en período de retención de 30 días tras eliminarse. Elige un nombre diferente. "Formato inválido del nombre" El nombre tiene caracteres especiales, espacios o mayúsculas. Usa solo letras minúsculas, números y guiones bajos. "Límite de ediciones alcanzado" Meta limita las ediciones en plantillas APPROVED a 1 por día y 10 por mes (por plantilla). Espera a que la ventana se renueve. "No se puede editar la plantilla" Ocurre cuando Meta aún no liberó la ventana de edición (generalmente en PAUSED). Sincroniza manualmente para asegurarte del estado actualizado y vuelve a intentarlo. Buenas prácticas :::success Usa la vista previa en vivo como lista de control visual. Antes de guardar, mira la vista previa y pregunta: ¿el mensaje es claro? ¿Variables en los lugares correctos? ¿El botón tiene el texto esperado? ::: :::info Llena ejemplos realistas en las variables. Meta usa estos valores para revisar — ejemplos genéricos como "prueba" o "abc" aumentan las probabilidades de rechazo. ::: :::warning Las plantillas de Marketing tienen criterios más estrictos. Si es posible, clasifícalas como Utilidad cuando sean transaccionales (confirmación de pedido, recordatorio de consulta, actualización de estado). ::: Documentación oficial de Meta Para reglas detalladas sobre estructura de plantillas, categorías y motivos de rechazo, consulta la documentación de Meta: - Meta Developers — Plantillas de mensajes

Última actualización el May 27, 2026

Cómo evitar bloqueos y baneos en WhatsApp

Cómo reducir riesgos de bloqueo en WhatsApp? - 🚫 Evita enviar mensajes a muchos contactos diferentes al principio. - 🔐 Solicita opt-in antes de campañas promocionales (“Quiero recibir novedades”). - 💬 Usa mensajes personalizados que incentiven respuesta. - 📆 Aquece el número antes de comenzar (úsalo normalmente durante algunos días). - 🧠 Evita repetir patrones del número anterior (nombre, foto, texto). - 🛑 Nunca envíes mensajes sin ofrecer opción de darse de baja. - ⚠️ Si más del 3% de los destinatarios marcan como spam, el número puede ser baneado. - 🧪 El algoritmo cambia. La única estrategia infalible es adaptarse constantemente. Introducción WhatsApp es una de las principales herramientas de comunicación en Brasil — y también una de las más reguladas. La plataforma aplica criterios estrictos para identificar comportamientos sospechosos, con el fin de proteger a sus usuarios contra spam, estafas y contenidos no deseados. Por eso, es fundamental entender los principales factores que pueden llevar al bloqueo de números y cómo protegerse. A continuación, compartimos aprendizajes de campo con miles de cuentas analizadas y operadas en los últimos años, además de recomendaciones actualizadas y fáciles de aplicar. ¿Cuáles son las principales causas de baneo? 1. Alta rotación de destinatarios WhatsApp detecta como comportamiento sospechoso cuando un número intenta enviar mensajes a muchas personas en poco tiempo — especialmente si esas personas nunca interactuaron con ese número antes. Consejo práctico: Comienza despacio. Envía mensajes en ritmo creciente, priorizando contactos que ya hayan interactuado contigo. 2. Contenido sospechoso o mensajes demasiado estandarizados El contenido de los mensajes es analizado por algoritmos de machine learning. Palabras como “boleto”, “PIX”, “tarjeta”, entre otras relacionadas con transacciones financieras, aumentan el riesgo — principalmente si se envían sin contexto o interacción real. Consejo práctico: Evita enviar mensajes genéricos a una base grande. Prefiere enfoques personalizados y que inviten a responder. Frases que fomenten la interacción del cliente disminuyen las chances de bloqueo. 3. Números nuevos y sin historial Las cuentas recién activadas que comienzan enviando mensajes masivos tienden a ser baneadas más rápidamente, incluso si el envío es manual o vía WhatsApp Web. Consejo práctico: Usa el número normalmente durante algunos días antes de comenzar campañas. Envía mensajes a contactos conocidos, interactúa por la app y llena el perfil con nombre, foto y descripción. 4. Reutilización de patrones tras bloqueo Es común reactivar un número nuevo después de que el anterior fue baneado y repetir exactamente la misma estrategia (foto, nombre, mensajes, etc.). Esto facilita la asociación entre perfiles y lleva al baneo casi inmediato. Consejo práctico: Cambia foto de perfil, nombre y estilo de comunicación. También modifica los patrones de horarios y destinatarios iniciales. El objetivo es no parecer una continuación directa del número anterior. 5. Reclamos y marcas como spam Si más del 3% de los destinatarios de una campaña marcan tu mensaje como spam, el número puede ser suspendido o baneado. Consejo práctico: Siempre ofrece una forma clara de darse de baja (ej.: “Responde 2 para salir de la lista”) y monitorea las respuestas para excluir automáticamente esos contactos. Estrategias adicionales que funcionan ✅ Realiza la "maduración" del número Antes de automatizar, usa el número de forma orgánica. Conversa con contactos reales, participa en grupos, responde mensajes. ✅ Solicita opt-in antes de enviar promociones Envía mensajes promocionales solo a quienes hayan autorizado explícitamente. Esto puede hacerse mediante formulario, checkbox o simplemente con “Quiero recibir promociones” en WhatsApp. ✅ Comienza por WhatsApp Web Usa primero el número en WhatsApp Web antes de conectarlo a tu plataforma. Esto ayuda a señalar que hay un humano detrás de la cuenta. ✅ Varía el contenido de los mensajes Utiliza atributos dinámicos (nombre del cliente, datos de compra, fecha, etc.) o mezcla las frases para evitar repeticiones iguales. ✅ Evita picos repentinos en el envío Si escalas una campaña, distribuye el volumen de mensajes a lo largo del día o la semana. Plataformas con colas automáticas ayudan a controlar este ritmo. Lo que no funciona (o funciona menos de lo que imaginas) - ❌ Rotación constante de IPs: puede ayudar en algunos casos, pero no resuelve si el problema es el contenido o el comportamiento del número. - ❌ Números reciclados: el historial previo cuenta. Un número usado para spam en el pasado puede ser baneado incluso con pocas mensajes enviados. - ❌ Cambiar de número sin cambiar el enfoque: repetir patrones anteriores genera rastreo automático. Conclusión No existe una fórmula mágica — el algoritmo de WhatsApp está en constante evolución. Lo que realmente importa es: - La calidad de la base de contactos. - El contexto y la personalización de los mensajes. - La interacción genuina con los usuarios. Las empresas que construyen relaciones con los clientes, respetan el consentimiento y mantienen una frecuencia saludable tienen tasas de bloqueo cercanas a cero.

Última actualización el Feb 25, 2026

¿Cuál es el límite de números de WhatsApp conectados y cómo aumentarlo?

¿Qué es el límite de números en la plataforma de WhatsApp Business? Cuando utilizas la API oficial de WhatsApp (WABA), tu cuenta tiene un límite en la cantidad de números de teléfono que se pueden agregar y conectar. Este límite es controlado por Meta basándose en criterios técnicos y de reputación. ¿Cuál es el límite inicial? - Si el Administrador comercial no está verificado, el límite predeterminado es: 2 números por WABA - Si el Administrador está verificado, el límite puede aumentarse hasta 20 números, pero esto no es automático Importante: Incluso después de verificar la empresa, Meta puede mantener el límite en 2, 5, 10 u otro valor inferior a 20, dependiendo de una combinación de criterios (ver más abajo). Es posible incrementar el volumen a más de 20 líneas, pero, como se explica a continuación, deberás abrir un ticket con Meta para que hagan esta excepción para ti. ¿Qué criterios influyen en el límite? Además de la verificación de la empresa, Meta también considera: Criterios técnicos y de reputación: - Historial de uso de la API (estabilidad, volumen de mensajes) - Cumplimiento de las políticas comerciales - Calidad de los mensajes y la experiencia del usuario - Ausencia de bloqueos, denuncias o comportamientos abusivos - Capacidad de soporte y operación de múltiples números Criterios subjetivos/comportamentales: - Relevancia del uso de múltiples números para el modelo de negocio (ej: franquicias, departamentos) - Tipo de operación (ej: multimarcas, países diferentes) - Nivel de estructura de la empresa o agencia colaboradora Conclusión: La verificación de la empresa es necesaria, pero no garantiza automáticamente los 20 números. La liberación también depende de la reputación y la consistencia de la operación. ¿Cómo saber si tu cuenta está verificada? Accede al panel de Meta: https://business.facebook.com/settings/info - Si aparece como “Verificada”, ya has cumplido el primer requisito. - Si aún no está, haz clic en “Iniciar verificación” y sigue los pasos con documentos y dominio. ¿Cómo solicitar un aumento del límite? Si tu cuenta aún no ha sido verificada: 1. Accede al enlace anterior y completa la verificación. 2. La cuenta será analizada y el límite podrá ajustarse automáticamente o mantenerse con restricción. Si tu cuenta ya fue verificada, pero tú: - Aún tienes el límite en 2 o 5 números - O alcanzaste los 20 números y necesitas más Deberás abrir un ticket con Meta. Cómo abrir un ticket para solicitar aumento de límite La mejor y más rápida opción es si eres cliente de Meta con un Gestor de Cuentas, pudiendo solicitar ayuda y abriendo un ticket directamente con esa persona. Si no es así (o tu gestor no responde), accede a: https://business.facebook.com/business/help/support Utiliza este ejemplo de mensaje: Asunto: Solicitud de aumento en el límite de números conectados a WABA Hola, Quisiera solicitar el aumento en el número de líneas telefónicas que podemos agregar a nuestra cuenta de WhatsApp Business (WABA). Nuestro Administrador comercial está verificado y estamos usando el límite actual. La operación justifica el uso de más números debido a nuestro modelo (ej: multimarcas, países, departamentos distintos). ID del Administrador comercial: [inserta aquí] ID de la cuenta WABA: [inserta aquí] Agradecemos el soporte y quedamos atentos. Enlaces útiles - Verificación del Administrador comercial - Centro de ayuda de Meta para WhatsApp Business - Abrir soporte en Meta - Guía para añadir números a la WABA - Entendiendo los niveles de envío de mensajes

Última actualización el Feb 25, 2026

¿Qué es la “coexistencia” en WhatsApp (WABA + celular)?

La coexistencia es una funcionalidad de Meta que permite que un mismo número de WhatsApp sea utilizado simultáneamente en el teléfono móvil (a través de WhatsApp Business App) y por herramientas que usan la API oficial de WhatsApp (WABA), como Cloud Humans. Es decir: Puedes seguir usando el número en el teléfono móvil normalmente y, al mismo tiempo, automatizar mensajes o atenciones mediante la API oficial, con soluciones como ClaudIA, CloudChat o Flujo Controlado. ¿Cómo funciona en la práctica? Con la coexistencia activada: - En el teléfono móvil (WhatsApp Business App): sigues pudiendo enviar y recibir mensajes manualmente, como siempre. - En la API oficial (WABA): puedes usar bots, helpdesks, integraciones con sistemas, envíos automatizados, etc. - Ambos acceden al mismo historial de conversaciones. Importante: la sincronización entre teléfono móvil y API es en tiempo real. Si alguien responde desde el teléfono, el sistema en la API lo detecta. Si ClaudIA responde vía API, esto se refleja en la app. ¿Qué cambia para quienes usan Cloud Humans? Puedes usar: - ClaudIA para automatizar parte del atención vía API; - CloudChat como helpdesk con agentes humanos; - Flujo Controlado para buscar datos de tu sistema y responder vía API; - Mantener grupos (no funcionarán en Cloud Chat ya que no funciona en la API, pero se mantienen en el teléfono); - Y seguir utilizando el número en el teléfono, como apoyo para el equipo. Esto es excelente para equipos que quieren automatizar gradualmente la atención o mantener parte del soporte manual en el teléfono mientras prueban la IA. Ej.: vendedores o managers que necesitan el teléfono. ¿Cómo habilitar la coexistencia? Sigue el paso a paso en este FAQ o contacta a nuestro soporte. ¿Cuáles son los principales casos de uso de la coexistencia? - Transición gradual a la API sin perder el uso del teléfono. - Equipos pequeños que usan el teléfono como apoyo, pero quieren automatizar parte del atención. - Pruebas de automatizaciones o bots, mientras aún hay atención humana vía app. - Redundancia/respaldo manual en caso de problemas con automatizaciones. ¿Existen limitaciones? Sí, algunas: - La experiencia en el teléfono puede volverse más lenta si hay muchos flujos corriendo por la API. - No es posible enviar mensajes simultáneamente por el teléfono y por la API a un mismo contacto — puede haber conflicto de sesiones. - Algunos recursos avanzados de la API (como plantillas con botones o medios interactivos) no son visibles en la app del teléfono igual que en el sistema de Cloud Humans. - Los grupos siguen sin ser soportados por la API oficial (solo permanecen en el teléfono). - ⚠️ Mensajes enviados o recibidos en dispositivos no soportados (como WhatsApp Desktop para Windows o WhatsApp en WearOS) no se reflejan en Cloud Chat — aunque permanecen visibles en el teléfono principal. Esto sucede porque Meta no genera webhooks (smb_message_echoes) para estos dispositivos. Para más detalles, consulta el artículo: Limitación de coexistencia: mensajes de apps no soportadas por Meta (ej: WhatsApp Desktop) no se reflejan en Cloud Chat. 📘 Importante: WhatsApp Web (navegador) es soportado y los mensajes se reflejan normalmente vía API. ¿Cloud Humans es compatible con la coexistencia? ¡Sí! Toda nuestra plataforma (ClaudIA, CloudChat y Flujo Controlado) es 100% compatible con la coexistencia, pero debes usar CloudChat. ¿Cuántos números puedo conectar vía API? ¿Cómo aumentar el límite? Por defecto, cada cuenta verificada inicia con un límite inicial de 2 números de WhatsApp conectados vía API oficial (WABA). Para aumentar este límite, Meta evalúa automáticamente algunos criterios: - Volumen significativo de uso (mínimo 1.000 conversaciones iniciadas por la empresa en 30 días). - Alta calidad de los mensajes (bajo índice de bloqueos o reclamaciones). Al cumplirse estos criterios, tu límite puede aumentar automáticamente hasta 20 números. Si necesitas más de 20, debes contactar directamente con soporte de Meta a través de Enterprise Support. Creamos una FAQ específica sobre límites de números (líneas) que puedes consultar aquí. En este sitio de Meta tienes más información: https://developers.facebook.com/docs/whatsapp/cloud-api/phone-numbers/?utm_source=chatgpt.com Enlaces útiles - Página oficial de Meta sobre Coexistencia (WhatsApp Business App + API) - Guía de migración y soporte de la API oficial de WhatsApp

Última actualización el Jun 24, 2026

Migrando WhatsApp a la Nube Chat desde otra plataforma de atención

Cuándo usar - Estás cambiando de plataforma de atención (Zendesk, Intercom, Zenvia, Twilio, Take Blip, etc.) y necesitas llevar el número. Requisitos previos :::error Antes de comenzar la migración, confirma todos los ítems a continuación. Saltarse alguno puede resultar en pérdida del número o bloqueo por parte de Meta. ::: - Acceso al número para recibir SMS o llamada de verificación - Acceso de administrador al Portafolio Empresarial en Meta - Estado del Portafolio Empresarial: "Verificado" - Estado del WABA: "Aprobada" - Estado del número: "Conectado" - Verificación en dos pasos desactivada del número en WABA (paso más crítico — vea abajo) - Tarjeta de crédito habilitada para pago en dólares — obligatorio en migración desde otra plataforma o para envíos proactivos Paso a paso de la migración Etapa 1 — Confirmar estado del Portafolio Empresarial Validando el Estado del Portafolio Empresarial El Portafolio Empresarial (Business Portfolio) debe tener el estado "Verificado" en Meta. Esto significa que Meta reconoció y validó la identidad de tu empresa. ¿Por qué es importante? Sin la verificación, estás sujeto a límites muy bajos en el envío (hasta 250 mensajes/día), no puedes migrar números de otros proveedores y puedes tener restricciones en funcionalidades de la API. La verificación es el primer requisito para una operación saludable en la plataforma de Meta. Cómo verificar: 1. Accede a business.facebook.com/settings/info 2. Verifica el campo Estado de la verificación 3. Debe estar como "Verificado" ✅ :::warning Si aparece como "No verificado" o "Pendiente", haz clic en Iniciar verificación y sigue el proceso con documentos y dominio de la empresa antes de continuar. ::: Etapa 2 — Confirmar propiedad del WABA y validar los requisitos previos ¿Qué es el WABA? WABA significa Cuenta de WhatsApp Business — es la entidad creada por Meta que representa la cuenta oficial de WhatsApp de tu empresa. Es a través del WABA que un número de teléfono se conecta a la API oficial y se vincula a un proveedor de atención (como Cloud Chat). El WABA siempre está dentro de un Portafolio Empresarial en Meta. Quien posee ese portafolio, en la práctica, es el dueño del WABA. :::warning ⚠️ En muchos casos, el proveedor anterior creó y mantiene el WABA en su portfolio — y no en el tuyo. Esto significa que no tienes control administrativo sobre tu número. Antes de migrar, es fundamental confirmar dónde está tu WABA. ::: ¿Cómo confirmar que eres el dueño del WABA? 1. Accede a Meta Business Manager 2. En el menú lateral, ve a Configuración → Cuentas de WhatsApp 3. Puedes localizar el WABA correspondiente a tu número en la lista o usando la barra de búsqueda. :::success Si aparece en tu portafolio → tienes control. Continúa con la validación de los requisitos previos abajo. ::: :::warning Si no aparece (o está en el portfolio del proveedor anterior) → contacta a nuestro soporte antes de continuar. Será necesario solicitar la transferencia del WABA a tu portafolio antes de migrar. ::: Validando el Estado del WABA: "Aprobada" Con el WABA localizado en tu portafolio, confirma que su estado es "Aprobada": 1. Aún en WhatsApp Manager, localiza tu WABA :::success El estado debe aparecer como "Aprobada" ✅. Además, debe existir un método de pago válido registrado en "Payment Settings". ::: :::warning Si está como "Restringida" o "Sinalizada", el WABA tiene pendientes con Meta que deben resolverse antes de migrar. ::: Validando el Estado del número: "Conectado" El número a migrar debe tener estado "Conectado" en el WABA: 1. Dentro del WABA, ve a WhatsApp Manager. Se abrirá una nueva pestaña en tu navegador con la lista de números vinculados en el WABA seleccionado. :::success El número debe aparecer con el estado "Conectado" ✅ ::: :::warning Si está como "Desconectado" o "Offline", es necesario solucionar esa situación antes de iniciar la migración. ::: Etapa 3 — Desactivar la Verificación en Dos Pasos del WABA :::error Esta es la etapa más crítica y la que más problemas causa en migraciones. ::: La verificación en dos pasos (Two-Step Verification) es un PIN de seguridad configurado en el número dentro del WABA. Mientras esté activa, Meta no permite que el número sea migrado a otro proveedor. Cómo desactivar: 1. Accede a WhatsApp Manager 2. Selecciona el número que se migrará 3. Haz clic en Configuraciones → Verificación en dos pasos 1. Haz clic en Desactivar :::warning ⚠️ Si tu proveedor actual controla la Verificación en Dos Pasos (lo cual es común si la WABA fue creada por el proveedor), tendrás que solicitárselo a ellos que la desactiven. Sin esto, la migración no es técnicamente posible. ::: Etapa 4 — Iniciar la integración con Cloud Chat :::info Con todos los requisitos previos validados, ya puedes comenzar la integración. Para ello, ten a mano: - Acceso de administrador al Portafolio Empresarial en Meta (necesario para autorizar la conexión en el flujo de Embeded Signup) - Acceso al número para recibir el código de verificación por SMS o llamada - Tarjeta de crédito válida para pago en dólares — durante el proceso, Cloud Chat creará un nuevo WABA vinculado a tu portafolio con Cloud Humans como socio tecnológico en Meta. Este WABA necesitará un método de pago registrado. ::: 📌 ¿Cómo funciona el WABA creada por Cloud Chat? Al integrar, Cloud Chat crea un WABA dentro de tu portafolio en Meta, con Cloud Humans registrado como socio (Proveedor técnico). Esto significa que tú sigues siendo dueño de tu WABA — Cloud Humans solo opera como canal técnico de conexión con la API. Puedes desvincular en cualquier momento sin perder el número. Elige el modelo de integración y sigue el paso a paso correspondiente: - 👉 Integración SIN coexistencia (API exclusiva) — número funciona exclusivamente vía API, sin uso en celular - 👉 Integración CON coexistencia (Celular + API) — número funciona en celular y API simultáneamente :::warning Si aún no sabes qué modelo de integración elegir (con o sin coexistencia), lee primero el Guía Maestra. ::: Etapa 5 — Validar con el equipo de Cloud Antes de comenzar la conexión, envía a nuestro equipo la confirmación de que todos los requisitos previos fueron validados. Esto garantiza soporte inmediato ante cualquier incidencia durante el proceso. Observaciones - La migración puede tardar algunos minutos dependiendo del proveedor anterior y de la respuesta de Meta. - Después de la migración, el historial de mensajes del proveedor anterior no se importa automáticamente — los mensajes antiguos permanecen en el sistema del proveedor previo. - Si necesitas importar tickets antiguos a Cloud Chat, esto es posible vía API. Consulta: Importación de historial de tickets. - Nunca hagas ajustes si tienes dudas — un error en este proceso puede bloquear el número. Contacta soporte antes de continuar. - Documentación oficial de Meta sobre migración entre proveedores: Meta Developers — Migrando números de teléfono.

Última actualización el Sep 22, 2026

Cómo reconectar tu inbox de WhatsApp en Cloud Chat

Cuándo usarlo - Se perdió la conexión de tu inbox de WhatsApp y dejaste de enviar o recibir mensajes - Recibiste un correo informando que la inbox fue desconectada - Necesitas actualizar las credenciales de WhatsApp en la inbox Requisitos previos - Ser administrador de la cuenta en Cloud Chat - Tener acceso a la cuenta de Meta (Facebook) vinculada a la WABA del número Paso a paso de la reconexión Etapa 1 — Acceder a la inbox en Cloud Chat 1. En el menú lateral, ve a Configurações → Caixas de Entrada (Configuración → Bandejas de entrada) 2. Haz clic en la inbox de WhatsApp que deseas reconectar 3. Ve a la pestaña Configurações avançadas (Configuración avanzada) Etapa 2 — Iniciar la reconexión 1. En la sección Reconectar WhatsApp (Reconectar WhatsApp), haz clic en el botón Reconectar 2. Se abrirá una ventana de Meta (Facebook) — inicia sesión si es necesario 3. Selecciona la WABA y el número de teléfono que deseas reconectar 4. Confirma la autorización y espera a que la ventana se cierre :::success Cuando aparezca el mensaje "WhatsApp reconectado com sucesso" (WhatsApp reconectado con éxito), la integración fue restablecida y la inbox vuelve a operar normalmente. ::: Observaciones - El proceso toma solo algunos segundos. - Después de la reconexión, las etapas internas de integración se ejecutan automáticamente en segundo plano. - Si ocurre algún error, inténtalo de nuevo. Si el problema persiste, contacta al soporte. - Si sospechas que la desconexión fue causada por la eliminación manual del dispositivo (en integración con coexistencia), confirma en el celular si Cloud Chat todavía aparece en WhatsApp Business App → Dispositivos Conectados (Dispositivos vinculados) antes de reconectar.

Última actualización el Aug 03, 2026

Tiers de envío de WhatsApp: qué son y cómo avanzar

Cuándo usar - Quieres entender el límite de mensajes proactivos que puedes enviar por la WABA - Tu cuenta alcanzó el límite y quieres saber cómo subir de tier - Estás planificando una campaña y necesitas dimensionar el tier necesario - Tu tier retrocedió y quieres entender por qué Sobre este artículo Los tiers (niveles) de envío son los límites de mensajes iniciados por la empresa que puedes enviar en una ventana de 24 h. Los controla Meta y se aplican solo a las plantillas (mensajes proactivos). :::info Los tiers no limitan los mensajes recibidos ni las respuestas dentro de la ventana de 24 h. El límite se aplica únicamente a las conversaciones iniciadas por la empresa mediante plantillas. ::: Tabla de tiers | Tier | Límite de conversaciones por 24 h | Cómo llegar aquí | |-------------|-----------------------------------|-----------------------------------------------------| | Tier 1 | 1.000 conversaciones | Punto de partida de toda cuenta nueva verificada | | Tier 2 | 10.000 conversaciones | Avance automático según calidad y volumen | | Tier 3 | 100.000 conversaciones | Avance automático según calidad y volumen | | Tier 4 | Ilimitado | Avance automático según calidad y volumen | :::warning Las cuentas no verificadas empiezan con un límite aún menor (250 conversaciones por 24 h) y solo avanzan después de la verificación del Business Portfolio en Meta. ::: Cómo avanza el tier automáticamente Meta aumenta tu tier cuando detecta las siguientes señales: 1. Volumen creciente — estás iniciando muchas conversaciones y te acercas al límite actual 2. Alta calidad — baja tasa de bloqueos y denuncias de spam por parte de los usuarios 3. Consistencia — uso regular sin picos sospechosos de volumen El proceso es automático: no necesitas solicitar el avance, ocurre en hasta 24 h cuando se cumplen los criterios. ¿Por qué aumentó mi límite? Meta evaluó que tu cuenta tiene volumen creciente + buena reputación de calidad. Eso es positivo — significa que puedes escalar tus campañas con más margen. ¿Por qué mi límite no está avanzando? Las causas más comunes: - Tasa de bloqueo elevada — usuarios que marcan tus mensajes como spam. Por encima del 3 % de denuncias, el avance se bloquea y el tier incluso puede retroceder - Volumen todavía bajo — estás lejos del límite actual y Meta no ve la necesidad de ampliarlo - Mala calidad de las plantillas — las plantillas con lenguaje promocional excesivo o sin un contexto transaccional claro tienden a generar más denuncias - Business Portfolio no verificado — sin verificación, el límite máximo es de 250 conversaciones/24 h y no avanza Cómo hacer seguimiento de tu tier actual 1. Accede a WhatsApp Manager 2. Selecciona el número deseado 3. Haz clic en Insights o Phone Number Settings 4. Verás el tier actual y el límite de conversaciones por 24 h ¿Qué hago si necesito más de 1.000 conversaciones desde el inicio? :::warning No es posible "saltar" tiers mediante una solicitud directa. La única forma es crecer orgánicamente con calidad. ::: Algunas prácticas que ayudan: - Empieza con una base de contactos que ya interactuó contigo — esas personas tienen menos probabilidad de marcarte como spam - Usa plantillas bien estructuradas con contexto claro (pedido, ticket, número de caso) - Monitorea las métricas de calidad en WhatsApp Manager semanalmente - Evita enviar a listas frías sin opt-in explícito ¿Los tiers y el límite de números conectados son lo mismo? No — son dos cosas diferentes: - Tier de envío: cuántas conversaciones por día puedes iniciar con un número específico - Límite de números: cuántos números de WhatsApp puedes conectar en tu WABA Para entender el límite de números: ¿Cuál es el límite de números de WhatsApp conectados y cómo aumentarlo? Observaciones - El tier puede retroceder si la calidad cae — cuida la reputación del número con atención continua - Los tiers son por número de teléfono, no por cuenta ni por WABA — cada número tiene su propio tier - Para evitar bloqueos y baneos y mantener la calidad del número: Cómo evitar bloqueos y baneos en WhatsApp - Documentación oficial de Meta: Meta Developers — Message Sending Limits

Última actualización el Aug 03, 2026

FAQ — Integración con WhatsApp: preguntas frecuentes

Cuándo usarlo - Tienes una duda puntual sobre la integración de WhatsApp y quieres una respuesta rápida - Estás en preonboarding y quieres tener a mano las respuestas frecuentes del equipo - Quieres mapear caminos alternativos antes de abrir un ticket de soporte Sobre el número y la cuenta ¿Necesito un chip físico o un celular para integrar? No necesariamente. Para la integración sin coexistencia (API exclusiva), no necesitas un chip físico: puedes usar un número virtual. Para la integración con coexistencia, necesitas el celular con la WhatsApp Business App instalada en el momento de la configuración. ¿Qué es un número virtual? ¿Dónde lo compro? Un número virtual es un número de teléfono que funciona sin chip físico, contratado en línea. Cloud Chat recomienda BR DID para quienes necesitan un número virtual para usar en la API. ¿Puedo usar mi número personal de WhatsApp? No lo recomendamos. La WhatsApp Business API está pensada para números empresariales. Además, al integrar sin coexistencia, el número deja de funcionar en la app del celular, lo que causaría problemas si es tu número personal. ¿Puedo tener dos números de WhatsApp diferentes conectados en Cloud Chat? Sí. Cada número queda en una bandeja de entrada separada. De forma predeterminada, una cuenta verificada puede tener hasta 20 números conectados. Detalles: ¿Cuál es el límite de números de WhatsApp conectados? ¿Puedo conectar el mismo número en dos herramientas al mismo tiempo (por ejemplo, Cloud Chat y otra plataforma)? :::warning No. Un número solo puede estar conectado a un proveedor de API a la vez. Para migrar a Cloud Chat, primero es necesario desconectarlo del proveedor anterior. ::: Sobre la migración ¿Voy a perder el historial de mensajes al migrar? El historial de mensajes del proveedor anterior no se migra automáticamente: queda accesible solo en la plataforma antigua. Si necesitas importar tickets antiguos, es posible hacerlo mediante la API de Cloud Chat: Importación de historial de tickets. En la integración con coexistencia, se sincroniza el historial de los últimos 6 meses de la WhatsApp Business App, pero solo de forma parcial y sin garantía de que esté completo (limitación de Meta). Mi proveedor actual no quiere liberar el número. ¿Qué hago? Contacta al equipo de soporte de Cloud Humans: existen caminos alternativos que dependen del análisis de cada caso. Antes, confirma: ¿la WABA está en tu Business Portfolio de Meta o en el portafolio del proveedor? Si está en el tuyo, tienes control administrativo y puedes migrar por tu cuenta. Necesito desactivar la Two-Step Verification antes de migrar. ¿Cómo lo hago si no sé la contraseña? - Si eres el dueño de la WABA → entra al WhatsApp Manager y desactívala directamente - Si el proveedor anterior controla la Two-Step Verification → solicítale que la desactive :::error Sin desactivar la Two-Step Verification, la migración no es técnicamente posible. ::: Sobre la coexistencia ¿Qué es la coexistencia? La coexistencia es la funcionalidad de Meta que permite usar el mismo número simultáneamente en el celular (WhatsApp Business App) y en la API oficial (Cloud Chat). Detalles: Qué es la coexistencia en WhatsApp. Si uso coexistencia, ¿qué pasa si el celular se queda sin batería o sin internet? Cloud Chat sigue funcionando normalmente mediante la API. La coexistencia no depende de que el celular esté activo. :::warning Si alguien elimina manualmente Cloud Chat de la lista de dispositivos vinculados en la app del celular, la integración se interrumpirá y habrá que rehacerla. ::: Mis mensajes de WhatsApp Desktop (Windows) no aparecen en Cloud Chat. ¿Por qué? WhatsApp Desktop para Windows y WhatsApp WearOS no son compatibles con Meta para el espejado mediante la API en modo coexistencia. Los mensajes quedan visibles en el celular, pero no generan webhook y por eso no llegan a Cloud Chat. WhatsApp Web (navegador) funciona normalmente. Detalles: ¿Los mensajes de WhatsApp no llegan a Cloud Chat? Entiende la limitación de la coexistencia. ¿Puedo usar grupos de WhatsApp en Cloud Chat? No. La API oficial de Meta no admite grupos. Los grupos siguen visibles solo en el celular (en modo coexistencia), pero no aparecen en Cloud Chat. Sobre plantillas y envíos ¿Qué son las plantillas y cuándo las necesito? Las plantillas son mensajes preaprobados por Meta, usados para iniciar conversaciones con clientes o para enviar mensajes después de la ventana de 24 h de inactividad. Para respuestas dentro de las 24 h siguientes al último contacto del cliente, no necesitas una plantilla. ¿Por qué mi plantilla fue rechazada como Utility? Meta reclasifica plantillas de Utility a Marketing cuando detecta lenguaje promocional, falta de contexto transaccional o un texto demasiado genérico. Para revertirlo: - Incluye un identificador claro (número de pedido, ticket, protocolo) - Usa un lenguaje objetivo - Elimina cualquier tono comercial Detalles: Reglas de plantillas de WhatsApp (Meta): categorías, estructura y rechazos. ¿Por qué no logro enviar mensajes a muchos contactos a la vez? Probablemente alcanzaste el límite de tu tier de envío. Cada cuenta comienza en el Tier 1 (1.000 conversaciones/24 h) y avanza automáticamente a medida que crecen el volumen y la calidad. Detalles: Tiers de envío de WhatsApp: qué son y cómo evolucionar. Troubleshooting rápido Cloud Chat dejó de recibir mensajes de WhatsApp. ¿Qué debo verificar? 1. Verifica si la bandeja de entrada está activa en Configuraciones → Bandejas de Entrada 2. Si usas coexistencia, verifica en el celular si Cloud Chat todavía aparece en Dispositivos Vinculados 3. Si el dispositivo fue eliminado, vuelve a conectarlo: Cómo reconectar tu inbox de WhatsApp en Cloud Chat 4. Si el problema persiste, contacta al soporte Mi mensaje aparece con error. ¿Qué significa? Consulta la guía completa con causas y acciones para cada código: ¿Por qué no se está enviando mi mensaje? Guía Completa de Errores. Observaciones - Para elegir el modelo de integración: Guía Maestro — Cómo conectar tu número de WhatsApp a Cloud Chat. - Documentación oficial de Meta sobre la WhatsApp Business Platform: Meta Developers — WhatsApp Business Platform.

Última actualización el Sep 22, 2026

Cómo conectar un número de WhatsApp sin coexistencia (exclusivamente vía API)

Cuándo usarlo - Quieres conectar un número al Cloud Chat que funcionará exclusivamente vía API, sin celular - Estás creando una operación 100% digital, con atención vía helpdesk o automatización - No necesitas usar el número en el WhatsApp Business App del celular - Quieres mayor estabilidad, sin conflicto entre dispositivos Requisitos previos :::error Iniciar la integración sin validar los puntos de abajo puede resultar en pérdida del número, bloqueo por parte de Meta, errores en el proceso de verificación o en la necesidad de rehacer toda la configuración. ::: :::warning ¿Migración de un número existente? Lee primero la guía de migración — lectura obligatoria. Si el número que quieres conectar ya está activo en otra plataforma de atención o en otro proveedor (BSP), NO inicies el flujo de integración en el Cloud Chat antes de leer: Migrando o WhatsApp para o Cloud Chat a partir de outra plataforma de atendimento Saltarte esa etapa puede resultar en: - Fallas en el proceso de verificación y migración trabada - Imposibilidad de liberar el número del proveedor anterior - Necesidad de rehacer toda la configuración desde cero La guía de migración muestra todos los requisitos previos de Meta (propiedad de la WABA, Verificación en Dos Pasos, estado del Business Manager, método de pago, historial de mensajes) que deben validarse antes de realizar la integración en el Cloud Chat. ::: :::warning ¿El número ya está registrado en el WhatsApp Business App del celular? La integración sin coexistencia (este artículo) NO permite que el número siga funcionando en el WhatsApp Business App. Para seguir por aquí, tendrás que: 1. Eliminar la cuenta del número en el WhatsApp Business App (borrar la app o quitar la cuenta dentro de ella) antes de iniciar el Registro Incorporado (Embedded Signup) 2. Aceptar que el número dejará de funcionar en el celular después de la integración — todos los mensajes pasarán a llegar exclusivamente al Cloud Chat Si quieres mantener el número funcionando en el WhatsApp Business App en paralelo al Cloud Chat, NO sigas este artículo. Usa el método de coexistencia: Como conectar um número do WhatsApp com coexistência (celular + API) ::: :::warning ¿Número nuevo? Hay que calentarlo antes de intentar integrarlo. Meta evalúa el historial de uso del número antes de liberar la conexión vía API. Los números recién creados, sin historial en el WhatsApp Business App, pueden ser bloqueados en el propio Registro Incorporado — Meta devuelve el error: Tu número de teléfono no está habilitado para conectarse a la plataforma de WhatsApp Business. Se necesita más actividad en la app de WhatsApp Business para ayudar a determinar la habilitación. (#3441045) Cómo calentarlo antes de integrar: - Usa el número en el WhatsApp Business App (celular) por algunos días / semanas, recibiendo conversaciones reales - Difunde el número en tus canales (sitio, redes sociales, correo) para generar entrada orgánica - Responde dentro de la ventana de 24 h, sin spam, sin mensajes repetidos, sin enlaces sospechosos Después del calentamiento, el número entra en la API con mejor tier y Quality Rating, y el Registro Incorporado pasa sin el error anterior. Documentación oficial de Meta: Messaging Limits · Quality Rating. ::: :::warning Validando el estado del Portafolio Empresarial El Portafolio Empresarial (Business Portfolio) debe estar con el estado "Verificada" en Meta. Eso significa que Meta reconoció y validó la identidad de tu empresa. ¿Por qué importa? Sin la verificación, quedas sujeto a límites muy bajos de envío (hasta 250 mensajes/día), no puedes migrar números de otros proveedores y puedes tener restricciones en funcionalidades de la API. La verificación es el primer requisito para una operación sana en la plataforma de Meta. Cómo verificarlo: 1. Accede a ++business.facebook.com/settings/info++ 2. Revisa el campo Estado de la verificación 3. Debe estar como "Verificada" ✅ Si está como "No verificada" o "Pendiente", haz clic en Iniciar verificación y sigue el proceso con documentos y dominio de la empresa antes de continuar. ::: Paso a paso de la integración sin coexistencia :::info Con todos los requisitos previos de arriba validados, ya puedes iniciar la integración. Para eso, ten a mano: - Ser administrador de la cuenta en el Cloud Chat - Acceso de administrador al Portafolio Empresarial en Meta (necesario para autorizar la conexión en el flujo de Embedded Signup) - Acceso al número para recibir el código de verificación por SMS o llamada - Tarjeta de crédito habilitada para pago en dólares — obligatorio en migración de plataforma de atención o para envíos proactivos ::: Etapa 1 — Acceder a la sección "Configurações" (Configuraciones) del Cloud Chat 1. En el Cloud Chat, accede a Configurações (Configuraciones) 1. Ve hasta la sección Caixas de Entrada (Bandejas de Entrada) Etapa 2 — Iniciar la creación de la bandeja de entrada de WhatsApp 1. Haz clic en Adicionar Caixa de Entrada (Agregar Bandeja de Entrada) 1. Selecciona WhatsApp 1. En la pantalla del Canal de WhatsApp, elige el proveedor Cadastro Incorporado (Embedded Signup) y completa el nombre deseado para la bandeja de entrada. Luego, haz clic en Entrar via WhatsApp para iniciar el flujo integrado Etapa 3 — Autenticarse en Meta En el pop-up de Meta que se abrirá, inicia sesión con la cuenta personal de Facebook de la persona que tiene acceso de administrador al Portafolio Empresarial (Business Portfolio) de la empresa en Meta. :::warning El inicio de sesión no se hace con un correo corporativo genérico ni con una "cuenta de la empresa" — es con el Facebook personal de quien es admin del portafolio empresarial en Meta. Sin ese permiso administrativo, el flujo de Registro Incorporado no consigue autorizar la conexión y la integración se traba en esta etapa. ::: 1. Después del inicio de sesión, haz clic en Continuar Etapa 4 — Seleccionar el Business Portfolio e iniciar la cuenta de WhatsApp 1. Elige el Business Portfolio en Meta y haz clic en Avanzar 1. Selecciona Empezar con un nuevo número de teléfono de WhatsApp y haz clic en Avanzar :::info Si quieres conectar un número que ya está en el WhatsApp Business App (modo coexistencia), interrumpe este flujo y sigue el passo a passo de integração com coexistência. ::: 1. Selecciona Crear una Cuenta Comercial de WhatsApp y haz clic en Avanzar Etapa 5 — Configurar la Cuenta Comercial y el número 1. Ingresa el nombre de la Cuenta Comercial de WhatsApp, el nombre para mostrar y elige una categoría válida 1. Selecciona Agregar un nuevo número, ingresa el número de teléfono y verifícalo :::warning Si el número es un teléfono fijo o un número digital, la verificación deberá hacerse por llamada telefónica, no por SMS. ::: Etapa 6 — Concluir y configurar el pago (si corresponde) :::error Cuándo el registro del método de pago es OBLIGATORIO: - Migración de un número existente — siempre obligatorio, sin excepción. Sin un método de pago válido, Meta no concluye la migración de la WABA. - Envío proactivo (template / campaña / mensaje unitario vía API) — obligatorio, porque Meta cobra por template enviado fuera de la ventana de 24 h. - Reapertura de la ventana de 24 h de Meta — obligatorio. Para iniciar una nueva conversación con un cliente fuera de la ventana activa, hay que enviar un template, y eso tiene costo directo cobrado por Meta a la tarjeta registrada. - Encuesta de satisfacción (CSAT) — el mensaje de CSAT también es un template de Meta. Si se envía fuera de la ventana de 24 h (caso común cuando el cliente no responde justo después de la atención), sin método de pago registrado el CSAT no se envía — el cliente no recibe la pregunta de evaluación y la métrica queda vacía. Sin una tarjeta válida registrada en la WABA, ningún mensaje proactivo sale, ninguna ventana se reabre y ningún CSAT se entrega fuera de la ventana — el número queda restringido a responder dentro de las 24 h posteriores al último mensaje del cliente. ::: 1. Haz clic en Adicionar método de pagamento (Agregar método de pago) para registrar el método de pago en la WABA. Para una atención puramente reactiva (responder mensajes dentro de la ventana de 24 h, sin envíos proactivos y sin migración), haz clic en "Finish". Etapa 7 — Agregar agentes a la bandeja de entrada 1. Configura los agentes que tendrán acceso a la nueva bandeja de entrada 1. Haz clic en Adicionar agentes (Agregar agentes) :::success La bandeja de entrada está lista para enviar y recibir mensajes en WhatsApp. ✅ ::: Observaciones - Migración: si este es un número ya en uso en otra plataforma, NO sigas este artículo aislado — empieza por la Guia de Migração para validar los requisitos previos de Meta antes del embedded signup - WhatsApp Business App: la integración vía API no convive con el número activo en el WhatsApp Business App del celular — elimina la cuenta de la app antes de seguir, o usa coexistência si quieres mantener el celular activo - Templates de Meta: para cualquier envío proactivo o reapertura de la ventana de 24 h, hay que tener una tarjeta válida + template aprobado — consulta Regras de templates do WhatsApp (Meta) y Como criar, editar e excluir templates de WhatsApp no Cloud Chat - El método de pago es obligatorio para migración, envíos proactivos y reapertura de la ventana de 24 h — para atención reactiva dentro de la ventana activa, no es necesario en el momento de la integración - Para mantener el número funcionando en el celular en paralelo, usa la integração com coexistência - En caso de duda o error, contacta al soporte antes de continuar — ajustes hechos incorrectamente pueden generar el bloqueo del número - Documentación oficial de Meta: Meta Developers — Embedded Signup

Última actualización el Aug 19, 2026

Cómo conectar un número de WhatsApp con coexistencia (App + API)

Cuándo usarlo - Ya usas el número en el WhatsApp Business App (celular) y quieres seguir usándolo - Quieres probar la API y automatizaciones sin renunciar al uso manual por celular - Tu equipo (vendedores, consultores, account managers) necesita seguir usando el celular - Quieres una transición gradual hacia la API sin interrumpir la operación actual Limitación importante de la coexistencia: dispositivos no compatibles Meta tiene una limitación oficial en el modelo de coexistencia: los mensajes intercambiados por el WhatsApp Desktop (Windows) o por el WhatsApp en WearOS no llegan al Cloud Chat — aunque aparezcan en el celular, y tampoco llegan al destinatario. Esta limitación solo afecta a la coexistencia; en el modelo sin coexistencia (API exclusiva) el problema no existe. Reporte típico del cliente: Los mensajes enviados por el agente no están llegando al cliente. Los mensajes del cliente aparecen en el celular, pero no en el Cloud Chat. :::info Detalles técnicos en la documentación oficial de Meta — en resumen, esas apps no disparan el webhook smb_message_echoes que la API usa para espejar la conversación. ::: Cómo sortearlo Migrar al modelo SIN coexistencia (API exclusiva): todos los mensajes pasan por la API, ya no hay conflicto entre dispositivos, y el número deja de funcionar en el celular. Paso a paso: Como conectar um número do WhatsApp via API oficial (sem coexistência). Requisitos previos :::error Iniciar la integración sin validar los puntos de abajo puede resultar en pérdida del número, bloqueo por parte de Meta, errores en el proceso de verificación o en la necesidad de rehacer toda la configuración. ::: :::warning ¿Migración de un número existente? Lee primero la guía de migración — lectura obligatoria. Si el número que quieres conectar ya está activo en otra plataforma de atención o en otro proveedor (BSP), NO inicies el flujo de Registro Incorporado antes de leer: Migrando o WhatsApp para o Cloud Chat a partir de outra plataforma de atendimento Saltarte esa etapa puede resultar en: - Fallas en el proceso de verificación y migración trabada - Imposibilidad de liberar el número del proveedor anterior - Necesidad de rehacer toda la configuración desde cero La guía de migración muestra todos los requisitos previos de Meta (propiedad de la WABA, Verificación en Dos Pasos, estado del Business Manager, método de pago, historial de mensajes) que deben validarse antes de realizar la integración en el Cloud Chat. ::: :::warning ¿Número nuevo? Hay que calentarlo antes de intentar integrarlo. Meta evalúa el historial de uso del número antes de liberar la conexión vía API. Los números recién creados, sin historial en el WhatsApp Business App, pueden ser bloqueados en el propio Registro Incorporado — Meta devuelve el error: "Tu número de teléfono no está habilitado para conectarse a la plataforma de WhatsApp Business. Se necesita más actividad en la app de WhatsApp Business para ayudar a determinar la habilitación." (#3441045) Cómo calentarlo antes de integrar: - Usa el número en el WhatsApp Business App (celular) por algunos días / semanas, recibiendo conversaciones reales - Difunde el número en tus canales (sitio, redes sociales, correo) para generar entrada orgánica - Responde dentro de la ventana de 24 h, sin spam, sin mensajes repetidos, sin enlaces sospechosos Después del calentamiento, el número entra en la API con mejor tier y Quality Rating, y el Registro Incorporado pasa sin el error anterior. Documentación oficial de Meta: Messaging Limits · Quality Rating. ::: :::warning Validando el estado del Portafolio Empresarial El Portafolio Empresarial (Business Portfolio) debe estar con el estado "Verificada" en Meta. Eso significa que Meta reconoció y validó la identidad de tu empresa. ¿Por qué importa? Sin la verificación, quedas sujeto a límites muy bajos de envío (hasta 250 mensajes/día), no puedes migrar números de otros proveedores y puedes tener restricciones en funcionalidades de la API. La verificación es el primer requisito para una operación sana en la plataforma de Meta. Cómo verificarlo: 1. Accede a ++business.facebook.com/settings/info++ 2. Revisa el campo Estado de la verificación 3. Debe estar como "Verificada" ✅ Si está como "No verificada" o "Pendiente", haz clic en Iniciar verificación y sigue el proceso con documentos y dominio de la empresa antes de continuar. ::: :::warning ¿No usas WhatsApp Business App en el celular? La coexistencia fue hecha para quien mantiene el número activo en el celular (WhatsApp Business App) en paralelo a la API. Si no vas a usar el número en el celular — solo en el Cloud Chat / API — este modelo no tiene sentido. Usa el método sin coexistencia: Como conectar um número do WhatsApp via API oficial (sem coexistência) ::: :::warning El número ya debe estar registrado y activo en el WhatsApp Business App (celular) antes de empezar — la coexistencia solo funciona si el número ya está vinculado y en uso en la app antes del Registro Incorporado. Si el número todavía no está en el WhatsApp Business App, instala la app y registra el número. ::: Paso a paso de la integración con coexistencia :::info Con todos los requisitos previos de arriba validados, ya puedes iniciar la integración. Para eso, ten a mano: - Ser administrador de la cuenta en el Cloud Chat - Acceso de administrador al Portafolio Empresarial en Meta (necesario para autorizar la conexión en el flujo de Embedded Signup) - Tener el celular con el WhatsApp Business App a mano para leer el QR code en la sincronización - Tarjeta de crédito habilitada para pago en dólares — obligatorio en migración de plataforma de atención o para envíos proactivos ::: Etapa 1 — Acceder a la sección "Configurações" (Configuraciones) del Cloud Chat 1. En el Cloud Chat, accede a Configurações (Configuraciones) 1. Ve hasta la sección Caixas de Entrada (Bandejas de Entrada) Etapa 2 — Iniciar la creación de la bandeja de entrada de WhatsApp 1. Haz clic en Adicionar Caixa de Entrada (Agregar Bandeja de Entrada) 1. Selecciona WhatsApp 1. En la pantalla del Canal de WhatsApp, elige el proveedor Cadastro Incorporado (Embedded Signup) y completa el nombre deseado para la bandeja de entrada. Luego, haz clic en Entrar via WhatsApp Etapa 3 — Autenticarse en Meta En el pop-up de Meta que se abrirá, inicia sesión con la cuenta personal de Facebook de la persona que tiene acceso de administrador al Portafolio Empresarial (Business Portfolio) de la empresa en Meta. :::warning El inicio de sesión no se hace con un correo corporativo genérico ni con una "cuenta de la empresa" — es con el Facebook personal de quien es admin del portafolio empresarial en Meta. Sin ese permiso administrativo, el flujo de Registro Incorporado no consigue autorizar la conexión y la integración se traba en esta etapa. ::: 1. Después del inicio de sesión, haz clic en Continuar Etapa 4 — Seleccionar el Business Portfolio y activar la coexistencia 1. Elige el Business Portfolio en Meta y haz clic en Avanzar 1. Selecciona Conectar WhatsApp Business App existente y haz clic en Avanzar Etapa 5 — Verificar el número 1. Selecciona Agregar un nuevo número, ingresa el número de teléfono y verifícalo :::warning Si el número es un teléfono fijo o un número digital, la verificación deberá hacerse por llamada telefónica, no por SMS. ::: Etapa 6 — Sincronizar con el WhatsApp Business App mediante QR code 1. Después de la verificación, haz clic en Concluir (Finalizar) para iniciar la sincronización con el WhatsApp Business App 2. Abre el WhatsApp Business en el celular, lee el QR code y sigue las instrucciones en el aparato Importación del historial de contactos y mensajes En el momento de la integración, el celular recibirá una notificación solicitando la importación del historial del número. Al confirmar, Meta sincroniza automáticamente el historial de mensajes y contactos de los últimos 6 meses hacia el Cloud Chat. :::warning Aunque la importación está prevista en la documentación oficial de Meta, en integraciones recientes observamos que Meta puede no enviar el historial completo en el momento de la sincronización. Es común que parte de los mensajes o algunos contactos no se importen. Ese comportamiento es intermitente y está fuera del control del Cloud Chat, ya que depende de la entrega de Meta. Mantén registros paralelos si es necesario. ::: Etapa 7 — Configurar el pago (si corresponde) :::error Cuándo el registro del método de pago es OBLIGATORIO: - Migración de un número existente — siempre obligatorio, sin excepción. Sin un método de pago válido, Meta no concluye la migración de la WABA. - Envío proactivo (template / campaña / mensaje unitario vía API) — obligatorio, porque Meta cobra por template enviado fuera de la ventana de 24 h. - Reapertura de la ventana de 24 h de Meta — obligatorio. Para iniciar una nueva conversación con un cliente fuera de la ventana activa, hay que enviar un template, y eso tiene costo directo cobrado por Meta a la tarjeta registrada. - Encuesta de satisfacción (CSAT) — el mensaje de CSAT también es un template de Meta. Si se envía fuera de la ventana de 24 h (caso común cuando el cliente no responde justo después de la atención), sin método de pago registrado el CSAT no se envía — el cliente no recibe la pregunta de evaluación y la métrica queda vacía. Sin una tarjeta válida registrada en la WABA, ningún mensaje proactivo sale, ninguna ventana se reabre y ningún CSAT se entrega fuera de la ventana — el número queda restringido a responder dentro de las 24 h posteriores al último mensaje del cliente. ::: 1. Haz clic en Adicionar método de pagamento (Agregar método de pago) para registrar el método de pago en la WABA. Para una atención puramente reactiva (responder mensajes dentro de la ventana de 24 h, sin envíos proactivos y sin migración), haz clic en "Finish". Etapa 8 — Agregar agentes a la bandeja de entrada 1. Configura los agentes que tendrán acceso a la nueva bandeja de entrada 1. Haz clic en Adicionar agentes (Agregar agentes) :::success La bandeja de entrada con coexistencia está integrada y lista para usar. ✅ ::: Observaciones :::error El Cloud Chat aparece en el celular como dispositivo conectado, en WhatsApp Business App → Dispositivos Conectados Si alguien quita el Cloud Chat de la lista de dispositivos en el celular, la integración se deshará y será necesario rehacer todo el proceso. ::: - Templates de Meta: para cualquier envío proactivo o reapertura de la ventana de 24 h, hay que tener una tarjeta válida + template aprobado — consulta Regras de templates do WhatsApp (Meta) y Como criar, editar e excluir templates de WhatsApp no Cloud Chat - El método de pago es obligatorio para migración, envíos proactivos y reapertura de la ventana de 24 h — para atención reactiva dentro de la ventana activa, no es necesario en el momento de la integración - Documentación oficial de Meta: Meta Developers — Embedded Signup with Coexistence

Última actualización el Aug 19, 2026

Conectando tu WhatsApp a Cloud Chat (vía Twilio)

En este tutorial, aprenderás cómo comenzar a usar WhatsApp a través de la API de Twilio en Cloud Chat. Paso 1: Comienza navegando a configuración. Paso 2: Selecciona Buzones. Paso 3: Elige agregar buzón. Paso 4: Luego, selecciona WhatsApp. Paso 5: En el campo Proveedor de API, selecciona Twilio. Luego, asigna un nombre para el buzón y el número telefónico que estás integrando. Paso 6: Necesitarás tu SID de cuenta de Twilio y tu Token de autenticación, que puedes encontrar en el Panel de Control de tu cuenta de Twilio. Paso 7: Localiza tu SID de cuenta en el panel y haz clic en el botón lateral para copiarlo, luego pégalo en el campo SID de la cuenta. Paso 8: Obtén el token de autenticación de Twilio desde el panel y pégalo en el campo Token de autenticación. Paso 9: Haz clic en Crear canal de Twilio para continuar. Paso 10: En esta sección, puedes agregar los agentes deseados a tu nuevo buzón. Paso 11: Copia la URL de callback generada y regresa a tu panel de Twilio. Paso 12: En tu cuenta de Twilio, ve a Remitentes -> Remitentes de Whatsapp. Paso 13: Selecciona el número que deseas usar en tu nuevo buzón. Paso 14: Asegúrate de que el campo Servicio de mensajería esté configurado en Ninguno y pega la URL de callback generada en el campo Webhook URL para mensajes entrantes. Paso 15: Haz clic en Actualizar remitente de WhatsApp. Paso 16: Tu buzón recién creado ahora está configurado. Para asegurarte de que ClaudIA tenga los permisos necesarios, ve a la pestaña de Colaboradores. Paso 17: En la lista de Agentes, asegúrate de que el agente ClaudIA esté asignado a este buzón. Paso 18: Ingresa a la configuración de Automatización. Paso 19: En la lista de Automatización, encuentra la automatización Asignar a Claudia y haz clic en el botón de editar. Paso 20: En la pantalla de Editar la regla de automatización, añade tu nuevo buzón en la lista de buzones resaltada a continuación: Paso 21: Repite el proceso descrito anteriormente con la automatización Mensaje creado: Siguiendo estos pasos, tu buzón de Twilio está configurado y podrás enviar y recibir mensajes en tu Cloud Chat desde el número configurado.

Última actualización el Sep 02, 2026

¿Por qué no se envía mi mensaje? Guía completa de errores (WhatsApp, Twilio y Correo Electrónico)

A veces, tu mensaje puede no enviarse y aparecer un mensaje de error. Hemos mapeado todos los casos utilizando el detalle de Meta sobre qué hacer cuando aparece cada tipo de error específico. Ejemplo de cómo aparece el mensaje de error. La caja estará con un color rojo y aparecerá un enlace ver detalles que abre una modal: Podrás ver el detalle del error haciendo clic en ver detalles: El cloudchat muestra el desglose de todos los códigos de error de Meta Errores más comunes y explicación detallada sobre ellos 🔴 131049 – WhatsApp – Incumplimiento de Políticas - Descripción: Mensaje no entregado para mantener una interacción saludable del ecosistema - Canal: WhatsApp - Qué significa: WhatsApp bloqueó la entrega por incumplimiento de políticas. - Causas comunes: - Contenido considerado spam o de baja calidad. - Alta tasa de bloqueos/reportes de usuarios. - Falta de opt-in válido. - Acción recomendada: - Revisar las plantillas aprobadas y el lenguaje utilizado. - Mejorar la recolección de opt-ins. - Monitorear métricas de calidad en Meta Business Manager. 🟠 131026 – WhatsApp – Mensaje no entregable (genérico) - Descripción: Mensaje no entregado - Canal: WhatsApp - Qué significa: No se pudo entregar el mensaje, sin detalles específicos. - Causas comunes: - Número inválido, desactivado o bloqueado. - El usuario desinstaló la aplicación. - Error temporal en la infraestructura de Meta. - Acción recomendada: - Validar los números antes de enviar. - Asegurar opt-in actualizado. - Reintentar envíos en caso de error transitorio. 🟡 131048 – WhatsApp – Límite de tasa de spam alcanzado - Descripción: Límite de tasa de spam alcanzado - Canal: WhatsApp - Qué significa: La cuenta superó el límite de envío permitido. - Causas comunes: - Volumen de envíos por encima del nivel de calidad. - Cuenta con reputación baja. - Acción recomendada: - Segmentar envíos. - Monitorear métricas de reputación. - Solicitar revisión de límites, si es necesario. 🟡 63024 – Twilio/Correo Electrónico/WhatsApp – Error genérico de API - Descripción: Código de error genérico de API de WhatsApp Cloud - Canal: Multicanal (Twilio, Email, WhatsApp) - Qué significa: Error genérico de la API, sin detalles específicos de la causa. - Causas comunes: - Tiempo de espera o fallo en la red. - Payload inválido. - Error transitorio en la API. - Acción recomendada: - Implementar reintento automático. - Validar payloads. - Escalar al soporte del proveedor en caso de repetición. 🟡 130472 – WhatsApp – Usuario no elegible - Descripción: El número del usuario forma parte de un experimento / no es elegible - Canal: WhatsApp - Qué significa: El número del usuario no puede recibir mensajes en este momento. - Causas comunes: - Número en sandbox/prueba de Meta. - Usuario no habilitado para recibir mensajes comerciales. - Acción recomendada: - Confirmar la elegibilidad del número. - Escalar al proveedor si es recurrente. 🟠 #100 – Facebook – Acción inválida - Descripción: Acción inválida (no es propietario del tema / llamada a API inválida) - Canal: Facebook (API) - Qué significa: La llamada realizada no es válida. - Causas comunes: - Endpoint incorrecto. - Token sin permisos. - Parámetros no válidos. - Acción recomendada: - Revisar payloads y permisos. - Consultar la documentación de la API Graph. 🔴 131042 – WhatsApp – Problema de elegibilidad empresarial - Descripción: Pago o cuenta no permitidos - Canal: WhatsApp - Qué significa: La cuenta no está apta para enviar mensajes. - Causas comunes: - Empresa en categoría restringida. - Falta de verificación en el Business Manager. - Pago pendiente. - Acción recomendada: - Resolver la facturación. - Verificar la elegibilidad en Meta Business Manager. 🟡 131047 – WhatsApp – Reintento de reenganche fallido - Descripción: Se excedió la ventana de 24h – Reintento de mensaje de reenganche fallido - Canal: WhatsApp - Qué significa: Se envió un mensaje fuera de la ventana de 24h sin usar plantilla. - Causas comunes: - Respuesta enviada después del límite permitido. - Acción recomendada: - Usar plantillas aprobadas para reenganche. - Configurar alertas para respetar la ventana. 🟡 Errores adicionales (por canal): - Correo Electrónico: - 451 4.7.1 → Límite de velocidad alcanzado en el servidor de correo. - 535-5.7.8 → Fallo en la autenticación SMTP. - 003 → Tiempo de espera de red en envío. - 2603 → Red inalcanzable. - Twilio: - 21617 → El mensaje supera los 1600 caracteres. - 63007 → Canal “From” inválido. - 63018 → Límite de velocidad. - 63049 / 63032 / 63016 → Errores genéricos del proveedor.

Última actualización el Sep 02, 2026

Cómo configurar conversación única en WhatsApp

Cuándo usar - Quieres que cada nuevo mensaje del cliente después de una conversación resuelta abra un nuevo ticket - Tu operación trata cada interacción como un evento aislado (no recurrente) - Prefieres tener más granularidad en los reportes (1 ticket = 1 atención) Requisitos previos - Estar conectado como administrador - Tener una bandeja de entrada de WhatsApp configurada Sobre este tutorial En este artículo aprenderás cómo configurar la función de conversación única en la bandeja de WhatsApp para que, cuando una conversación sea resuelta, se genere un nuevo ticket (en lugar de continuar una conversación existente eternamente). Video instructivo: https://youtu.be/sB6baeooG28 Paso a paso Etapa 1 — Acceder a la Configuración de la bandeja de WhatsApp 1. Ve a Configuración 2. Haz clic en Bandejas de entrada 3. Selecciona la bandeja de WhatsApp Etapa 2 — Activar Conversación Única Desplázate hasta el final de la configuración hasta encontrar Bloquear a conversación única. Comportamiento: - Desactivada (predeterminado) → si el cliente envía un nuevo mensaje después de que la conversación fue resuelta, se abre un nuevo ticket. Si todavía hay una conversación en curso (no resuelta), el mensaje entra en esa misma conversación - Activada → la conversación sigue siendo la misma, con el mismo responsable y la misma persona respondiendo :::info Recomendamos mantener la configuración desactivada, excepto en casos muy específicos que requieran una conversación única. ::: Recuerda Actualizar la configuración al final. Observaciones - Para entender el CSAT y configurarlo: Cómo configurar CSAT por canal y ver los resultados - Para entender los estados de los tickets (Abierto, Resuelto, etc.): Estados de tickets en Cloud Chat - Para configurar el tiempo de cierre automático: Resolución automática de tickets

Última actualización el Sep 02, 2026

Cómo replicar plantillas de WhatsApp entre WABAs vía API

¿Cuándo usarlo? Cuando necesitas llevar las plantillas de WhatsApp de una cuenta de WhatsApp Business (WABA) a otra. Por ejemplo: migración de número, una empresa con más de una WABA que quiere las mismas plantillas en todas, o cambio de portafolio en Meta Business. Meta no tiene un botón de "duplicar" entre cuentas, pero se puede hacer con la API de Meta (Graph API) en pocos pasos. Este procedimiento requiere a alguien con experiencia en llamadas de API. Si lo prefieres, habla con nuestro soporte y te ayudamos. :::warning No es posible clonar el estado de aprobado. Cada plantilla recreada en la WABA de destino pasa de nuevo por la aprobación de Meta (normalmente minutos, pero puede tardar hasta 24h). Planifica el cambio teniendo en cuenta este plazo, para no quedarte sin plantillas aprobadas en la cuenta nueva. ::: ¿Qué necesito antes? - El WABA ID de origen y el WABA ID de destino - Un access token con el permiso whatsapp_business_management que tenga acceso a las dos WABAs (de un usuario del sistema del Business Manager, por ejemplo) ¿Cómo lo hago, paso a paso? 1. Listar las plantillas aprobadas de la WABA de origen curl -G "https://graph.facebook.com/v{version}/{WABA_ID_ORIGEN}/message_templates" \ -d "status=APPROVED" \ -d "fields=name,language,category,parameter_format,components" \ -d "limit=100" \ -H "Authorization: Bearer {TOKEN}" La respuesta trae el nombre, idioma, categoría y contenido (components) de cada plantilla. Si hay más de 100, sigue el enlace paging.next de la respuesta hasta el final. 2. Crear cada plantilla en la WABA de destino Para cada elemento de la lista, envía un POST con los mismos datos. Quita los campos que son de la cuenta de origen (id, status, calidad, etc.) y envía solo name, language, category, parameter_format (si viene) y components. curl -X POST "https://graph.facebook.com/v{version}/{WABA_ID_DESTINO}/message_templates" \ -H "Authorization: Bearer {TOKEN}" \ -H "Content-Type: application/json" \ -d '{ "name": "bienvenida", "language": "es", "category": "UTILITY", "components": [ ...copiado del origen... ] }' 3. Seguir la aprobación Vuelve a consultar con el GET en la WABA de destino revisando el campo status hasta que todas estén APPROVED. Las que vuelvan como REJECTED necesitan un ajuste manual. ¿Qué puntos debo tener en cuenta? - Plantillas con multimedia en el encabezado (imagen, video, documento): el archivo de ejemplo del origen no sirve en la otra cuenta. Sube el archivo de nuevo con la Resumable Upload API, obtén el nuevo handle y reemplázalo en header_handle antes del POST. - Variables: mantén los ejemplos (example) que vienen en los components. Sin ellos, Meta rechaza la plantilla. - Límite de creación: como máximo 100 plantillas creadas por hora en cada WABA. Si son muchas, hazlo por lotes. - Límite total: 250 plantillas por WABA si el portafolio no está verificado (verificado permite muchas más). - Categoría: Meta puede reclasificar la categoría en la nueva aprobación (por ejemplo, de utilidad a marketing), lo que cambia el costo de envío. - Nombre: el mismo name + idioma no puede existir ya en la WABA de destino. Observaciones - Para crear, editar y usar plantillas dentro de Cloud Chat, consulta Plantillas de WhatsApp: crear, editar, eliminar y usar el constructor. - Para entender las categorías y los motivos de rechazo, consulta Reglas de plantillas de WhatsApp (Meta). - ¿Tienes alguna duda? Habla con nuestro soporte. Referencia oficial: Plantillas de mensajes (Meta for Developers)

Última actualización el Sep 23, 2026