# API de WhatsApp Business El creador de MaviBot también admite la API oficial de WhatsApp Business. ## Cómo conectar WhatsApp Business Para conectar la API de WhatsApp Business (WABA) a tu proyecto, ve a la **Mensajeros** sección y seleccione **API de WhatsApp Business**.
**Conectando la API de WhatsApp Business**
En la ventana que se abre, inicia sesión con tu cuenta de Facebook. Luego haz clic en el botón "Conectar vía Facebook". Si es necesario, introduce tu contraseña de Facebook para continuar.
La configuración ya está completa. No es necesario que mantengas tu teléfono en línea en todo momento; el bot funcionará de forma estable y autónoma. ## Plantillas de mensajes para la API de WhatsApp Business Al usar la API de WhatsApp Business, los usuarios no pueden escribir a los clientes en cualquier momento del día ni enviar mensajes ilimitados al crear un bot, similar al WhatsApp gris, fuera de la ventana de atención al cliente de 24 horas. Fuera de la ventana de 24 horas, solo se pueden usar plantillas de mensajes de WhatsApp (o mensajes de plantilla de WhatsApp), durante las cuales la comunicación se realiza de forma gratuita dentro de la categoría seleccionada. Esta funcionalidad se usa en WhatsApp para evitar envíos de spam limitando el número de mensajes permitidos en un cierto intervalo de tiempo, así como asignando una categoría a las plantillas. Meta ha instalado en WhatsApp Business Api las siguientes categorías de mensajes: 1\. Plantillas útiles (contienen información específica sobre transacciones, facturas, pagos, etc.); 2\. Plantillas para marketing (información sobre la empresa, organización, estrategias, publicidad y promoción); 3\. Plantillas para verificación y autenticación.
Las plantillas creadas para WABA están siendo moderadas. ### Las principales razones del rechazo de plantillas Una cantidad significativa de plantillas no supera la moderación de WhatsApp por varias razones: 1. **Publicidad excesiva:** WhatsApp Business rechaza plantillas sobrecargadas con anuncios y contenido promocional. Si los moderadores o la IA de la plataforma determinan que la publicidad eclipsa el mensaje principal, la plantilla será bloqueada. 2. **Violación de la política de productos:** se rechazarán las plantillas que promocionen artículos prohibidos como narcóticos, sustancias psicotrópicas, alcohol, tabaco, servicios íntimos o cualquier contenido considerado degradante para la dignidad humana. 3. **Ambigüedad, omisión o falsedad:** si los moderadores de WhatsApp detectan algún subtexto oculto, información engañosa o falta de detalles claros sobre tu empresa o servicio, la plantilla no será aprobada. 4. **Recopilación de información confidencial:** las plantillas diseñadas para recopilar datos sensibles del usuario (por ejemplo, números de pasaporte, datos de tarjetas bancarias, números de identificación personal, direcciones de domicilio) no superarán la moderación. 5. **Contenido ofensivo:** cualquier mensaje que contenga información que pueda ofender a los usuarios por raza, nacionalidad, género, identidad u otros criterios será rechazado. 6. **Rechazo discrecional:** los moderadores de WhatsApp se reservan el derecho de rechazar plantillas sin proporcionar un motivo específico. Cómo instalar plantillas de mensajes Como las plantillas se crean a partir de bloques, primero debes crear un bloque en tu flujo antes de usarlo para una plantilla de la API de WhatsApp Business. * **Costo y primer mensaje:** El envío de mensajes de plantilla es gratuito dentro de la ventana de conversación de 24 horas. El **primer mensaje** a un cliente solo puede ser una plantilla aprobada por Meta (Facebook). * **Después de 24 horas:** Una vez que hayan pasado 24 horas desde que se abrió el chat, solo puedes enviar otra plantilla aprobada para volver a interactuar con el usuario. * **Nota de moderación:** Las plantillas pueden no superar la moderación si contienen variables (ya sea en escritura cirílica o latina). ## **Creación de plantillas en MaviBot** 1. Ve a la pestaña **Canales** sección, selecciona **API de WhatsApp Business**y luego elige **Plantillas de mensajes**.
2. Haz clic en el **"Crear plantilla"** botón. Esto abre la página de creación de plantillas. 3. Las plantillas están vinculadas a bloques en tu flujo. De forma predeterminada, el contenido de la plantilla se toma del bloque, pero puedes especificar texto y botones personalizados.
4. La plantilla de mensaje se enviará a moderación al momento de su creación. **Solo puedes usar plantillas aprobadas.** La moderación suele tardar unas 8 horas, con un máximo de 48 horas. ## Tipos de plantillas Hay 3 tipos de plantillas disponibles para elegir. Puedes adjuntar una imagen a la **MARKETING** plantilla en los siguientes formatos: SVG, PNG, JPG y GIF. #### Cómo pasar variables en las plantillas Las variables en las plantillas se manejan igual que en todo MaviBot, no según el formato nativo de WhatsApp. {% hint style="danger" %} Nuestro sistema está adaptado para las variables de MaviBot y **no admite** variables en la `{{1}}` dar formato a {% endhint %} #### Uso de variables en mensajes de plantilla de WhatsApp Si necesitas usar variables en las plantillas de mensajes, sigue esta regla: **escribe siempre los nombres de las variables usando solo letras latinas**, por ejemplo, `#{example}`. Después de enviar, verifica que las variables se procesen correctamente comprobando el mensaje mediante la [enlace](https://business.facebook.com/wa/manage/message-templates/). Si una plantilla contiene una variable, pero el bot no le asigna un valor o el valor falta, el mensaje **no se enviará**! ## Cómo funcionan los botones en las plantillas Las plantillas de mensajes admiten botones. En MaviBot, los botones se configuran de forma similar a la sintaxis API de Facebook. Puedes familiarizarte con ella siguiendo la [enlace](https://developers.facebook.com/docs/whatsapp/business-management-api/message-): Los botones se configuran en formato de matriz JSON. **Parámetros de creación de botones:** | Parámetro | Obligatorio | Descripción | | ------------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | tipo | Sí | Valores: PHONE\_NUMBER, URL y QUICK\_REPLY | | text | Sí | Texto del botón | | url | No |

La URL que se abrirá

cuando se haga clic en el botón. Puedes usar variables para

crear enlaces dinámicos.

| | phone\_number | No |

El número de teléfono al que

se realizará la llamada cuando se pulse el botón

| | ejemplo | No |

Proporciona un ejemplo de los posibles datos para tu plantilla. Esto ayuda con el proceso de revisión y aprobación para que puedas

entender qué mensaje planeas enviar. Asegúrate

de que estos sean ejemplos y no contengan información confidencial o personal.

| Por ejemplo: Mensaje con dos botones: \[{"type":"QUICK\_REPLY", "text": "Sí, conveniente"}, {"type":"QUICK\_REPLY", "text": "Incómodo"}] ### Características de los botones en las plantillas Hay dos tipos de botones disponibles en los mensajes de plantilla: 1. **Call-To-Action (CTA):** Un botón para un enlace o número de teléfono (se muestra con un icono de enlace o de auricular junto a su texto). 2. **Respuesta rápida:** Botones de texto estándar con un límite de 20 caracteres. **Limitaciones:** * Una sola plantilla puede contener hasta **3 botones de Respuesta rápida** y hasta **2 botones de Llamada a la acción**. Sin embargo, no puedes usar dos enlaces o dos números de teléfono simultáneamente. * Los botones no pueden incluir variables, saltos de línea, emojis ni símbolos de formato. **Comportamiento:** * Al hacer clic en un **Respuesta rápida** botón, su texto se envía como un mensaje de respuesta del usuario. * Un **Llamada a la acción** botón puede abrir un enlace a un archivo. * Al hacer clic en un **Llamada a la acción** botón para una llamada telefónica abre el marcador estándar. En WhatsApp Web, aparecerá una notificación indicando que no se pueden realizar llamadas desde la versión de escritorio. ### Cómo funciona la moderación de plantillas Cada plantilla se envía a moderación inmediatamente después de su creación. El proceso suele tardar **unas 8 horas**, con un tiempo máximo de revisión de **48 horas**. Puedes seguir el estado de moderación en tu lista de plantillas. Si una plantilla es rechazada, se proporcionará el motivo del rechazo. **Las plantillas con alta probabilidad de aprobación suelen:** * Usar un lenguaje claro y profesional. * Servir a un caso de uso específico y legítimo (por ejemplo, recordatorios de citas, actualizaciones de pedidos). **Importante:** El texto en *cursiva* puede ser variable y personalizable. Hola, no hemos podido contactarte. ¿Te sería conveniente seguir comunicándote aquí? Hola, dejaste un mensaje en el sitio web y me pediste que me pusiera en contacto contigo.(sujeto a cambios) Hola, soy John Smith de MaviBot. Antes solicitaste la creación de un chatbot. Nos complace informarte de que tenemos algunas novedades para ti. Plantillas que no pasarán la moderación: cualquier texto publicitario #### **Cómo comprobar si estás dentro de la ventana de 24 horas** Puedes determinar cuántos días han pasado desde el último mensaje del cliente usando la `days_from_last_message()` función en tu condición de activación. **Ejemplo de comprobación de la ventana de 24 horas:** `days_from_last_message() == 0` ### Cómo usar botones sin plantillas Hay dos tipos de botones disponibles fuera de las plantillas, configurados de la misma manera que en otros mensajeros: 1. [**Botones de respuesta:**](/doc/es/chatbot/builder/botones.md) Un máximo de **3** se puede usar en un bloque. 2. [**Botones en línea**](/doc/es/chatbot/builder/botones.md)**:** Puedes crear hasta **10**y aparecen como se muestra en el ejemplo. **Limitaciones importantes para los botones que no son de plantilla:** * Los botones solo pueden contener **text**. **No se admiten enlaces.** * Su única función es **mover al cliente de un bloque a otro** dentro de tu flujo. *** **Restricciones para cuentas no verificadas** Las cuentas de Facebook Business no verificadas tienen los siguientes límites: * **50 mensajes de plantilla por día** (incluidos en la cuota mensual). * **Sin restricciones** en los mensajes entrantes. Para levantar estas restricciones, tu empresa debe completar el proceso de **Verificación de empresa** que normalmente tarda **2–3 semanas**. ## Sistemas de pago Consulta con tu revendedor el precio de los mensajes entrantes y salientes para cuentas no verificadas. {% hint style="info" %} El pago se realiza directamente a **360dialog**. {% endhint %} ## Errores de envío de mensajes **Posibles razones del fallo en la entrega:** 1. El número de teléfono del destinatario no está registrado en WhatsApp. 2. Intentando enviar una plantilla de la **"Autenticación"** categoría a un usuario de WhatsApp con el código de país **+91 (India)**. Actualmente, las plantillas de la categoría de Autenticación no pueden entregarse a usuarios en India. 3. El destinatario no ha aceptado la actualización de los **Términos del servicio** y **Política de privacidad**. 4. El mensaje no se entregó para mantener una experiencia de usuario de alta calidad (esto es un bloqueo general de la política). --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.mavibot.ai/doc/es/chatbot/mensajeros/waba.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.