El constructor de MaviBot también es compatible con 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 sección Mensajeros y selecciona API de WhatsApp Business.

Conexión de 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 a través de Facebook".

Si es necesario, ingresa tu contraseña de Facebook para continuar.

La configuración ahora está completa. No necesitas mantener tu teléfono en línea en todo momento; el bot funcionará de manera 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 a cualquier hora del día ni enviar mensajes ilimitados al crear un bot, similar al WhatsApp gris, fuera de la ventana de servicio 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 prevenir envíos masivos de spam al limitar la cantidad de mensajes permitidos en un intervalo de tiempo determinado, así como al asignar una categoría a las plantillas.

Meta ha instalado las siguientes categorías de mensajes para la API de WhatsApp Business:

  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 sujetas a moderación.

Las principales razones para el rechazo de plantillas

Un número significativo de plantillas no supera la moderación de WhatsApp por varias razones:

  1. Publicidad excesiva: WhatsApp Business rechaza plantillas sobrecargadas de 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 Producto: se rechazarán las plantillas que promuevan artículos prohibidos como estupefacientes, sustancias psicotrópicas, alcohol, tabaco, servicios íntimos o cualquier contenido que se considere 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 particulares) no superarán la moderación.
  5. Contenido ofensivo: cualquier mensaje que contenga información que pueda ofender a los usuarios por motivos de 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

Dado que 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 que haya sido 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 (en escritura cirílica o latina).

Creación de plantillas en MaviBot

  1. Ve a la sección Canales, selecciona API de WhatsApp Business y luego elige Plantillas de mensajes.

  1. Haz clic en el botón "Crear plantilla". Esto abre la página de creación de plantillas.
  2. Las plantillas están vinculadas a bloques en tu flujo. De forma predeterminada, el contenido de la plantilla se extrae del bloque, pero puedes especificar texto y botones personalizados.

  1. La plantilla de mensaje se enviará a moderación al crearla. 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 plantilla de MARKETING en los siguientes formatos: SVG, PNG, JPG y GIF.

Cómo pasar variables en plantillas

Las variables en las plantillas se manejan de la misma manera que en todo MaviBot, no según el formato nativo de WhatsApp.

Nuestro sistema está adaptado para las variables de MaviBot y no es compatible con variables en el formato {{1}}

Uso de variables en mensajes de plantilla de WhatsApp

Si necesitas usar variables en plantillas de mensajes, sigue esta regla: escribe siempre los nombres de las variables usando solo letras latinas, por ejemplo, #{example}. Después del envío, verifica que las variables se procesen correctamente revisando el mensaje a través del enlace proporcionado.

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 manera similar a la sintaxis de la

API de Facebook. Puedes familiarizarte con ella siguiendo el enlace:

Los botones se configuran en formato de matriz JSON.

Parámetros de creación de botones:

Parámetro Obligatorio Descripción
type 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 presione el botón
example No

Proporciona un ejemplo de 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": "Inconveniente"}]

Características de los botones en las plantillas

Hay dos tipos de botones disponibles en los mensajes de plantilla:

  1. Llamada a la acción (CTA): un botón para un enlace o número de teléfono (se muestra con un icono de enlace o 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 botón de Respuesta rápida, se envía su texto como mensaje de respuesta del usuario.
  • Un botón de Llamada a la acción puede abrir un enlace a un archivo.
  • Al hacer clic en un botón de Llamada a la acción para una llamada telefónica, se abre el marcador estándar. En WhatsApp Web, aparecerá una notificación que indica 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 realizar un seguimiento del 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 generalmente:

  • Usan un lenguaje claro y profesional.
  • Sirven para 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 comunicarnos contigo. ¿Te sería conveniente continuar comunicándonos aquí?

Hola, dejaste un mensaje en el sitio web y me pediste que me comunicara contigo. (sujeto a cambios)

Hola, soy John Smith de MaviBot. Anteriormente solicitaste la creación de un chatbot. Nos complace informarte que tenemos algunas noticias para ti.

Plantillas que no superarán la moderación:

cualquier texto publicitario

Cómo verificar 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 función days_from_last_message() en tu condición de activación.

Ejemplo de verificación de la ventana de 24 horas:

days_from_last_message() == 0

Restricciones para cuentas no verificadas

Las cuentas comerciales de Facebook no verificadas enfrentan los siguientes límites:

  • 50 mensajes de plantilla por día (incluidos en la tarifa mensual).
  • Sin restricciones en los mensajes entrantes.

Para eliminar estas restricciones, tu empresa debe completar el proceso de Verificación de la empresa, que generalmente toma 2 a 3 semanas.

Sistemas de pago

Consulta con tu revendedor los precios de los mensajes entrantes y salientes para cuentas no verificadas.

El pago se realiza directamente a 360dialog.

Errores de envío de mensajes

Posibles razones de fallo en la entrega:

  1. El número de teléfono del destinatario no está registrado en WhatsApp.
  2. Intento de enviar una plantilla de la categoría "Autenticación" 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 se pueden entregar a usuarios en India.
  3. El destinatario no ha aceptado los Términos de servicio y la Política de privacidad actualizados.
  4. El mensaje no se entregó para mantener una experiencia de usuario de alta calidad (esto es un bloqueo de política general).

Conversiones de anuncios de Click-to-WhatsApp

Una adición a la documentación para la función fb_pixel_event().

Meta* marca cada clic de un anuncio de Click-to-WhatsApp con un identificador de clic ctwa_clid. Se recibe junto con el primer mensaje de WhatsApp del cliente y se utiliza para atribuir una conversión de la conversación a un anuncio específico, de manera similar a como los eventos de píxel se atribuyen a un clic en el sitio web.

Firma

fb_pixel_event(
    event_name,
    pixel_id,
    access_token,
    event_source_url,
    action_source,
    fbc,
    test_event_code,
    data,
    ctwa_clid,
    messaging_channel
)

Nuevos parámetros

Parámetro Descripción
ctwa_clid Identificador de clic para un anuncio de Click-to-WhatsApp. Si no se proporciona este parámetro, se utiliza la variable de cliente ctwa_clid, que el bot guarda automáticamente. Opcional.
messaging_channel El canal de mensajería donde ocurrió la conversión. El valor predeterminado es whatsapp. Opcional.

Nuevo valor de action_source

Se agrega la siguiente fila a la tabla de valores de action_source:

Valor Descripción
business_messaging La conversión ocurrió en una conversación después de que el cliente hizo clic en un anuncio de Click-to-WhatsApp.

Un evento se envía como una conversión de mensajería si se cumple al menos una de las siguientes condiciones:

  • Se proporciona action_source="business_messaging";
  • Se proporciona ctwa_clid;
  • Se proporciona messaging_channel.

En este caso, Meta* recibe la combinación action_source + messaging_channel + ctwa_clid. Sin esta combinación, el clic en el anuncio no se atribuirá a la conversión.

El valor website no debe usarse para conversiones de mensajería: el evento llegará al píxel, pero no se atribuirá al anuncio.

Variables de cliente

Cuando un cliente envía un mensaje de WhatsApp después de hacer clic en un anuncio, el bot guarda los datos del clic en las variables de cliente del cliente. No es necesario completar estas variables manualmente.

Variable Descripción
ctwa_clid Identificador de clic. Se agrega automáticamente al evento.
ctwa_clid_time Hora en que se recibió el identificador, en formato de tiempo Unix. Se puede usar para determinar cuánto tiempo ha pasado desde el clic.
wa_ads_data Datos del anuncio en formato JSON: URL del anuncio, ID del anuncio (source_id), título, descripción, tipo de creativo y URL del creativo.

El identificador de clic se toma automáticamente de la variable de cliente, por lo que no es necesario pasarlo explícitamente a la función.

El número de teléfono del cliente se agrega automáticamente al evento si no se proporciona en data.

El parámetro event_source_url no se usa para conversiones de mensajería.

Limitaciones

El identificador de clic se recibe solo con el primer mensaje del cliente después de que hace clic en el botón del anuncio. No se incluye en mensajes posteriores. Por lo tanto, el evento se puede enviar en cualquier punto durante la conversación, pero solo si el primer mensaje se originó desde el anuncio.

Meta* proporciona ctwa_clid para clics desde las aplicaciones de Facebook* e Instagram* en Android e iOS.

El identificador no se proporciona cuando el cliente hace clic desde un navegador o hace clic en una publicación normal en lugar del botón del anuncio. Las conversiones de tales interacciones no se pueden atribuir al anuncio.

Si el cliente hace clic en otro anuncio más tarde, las variables se sobrescriben. La conversión se atribuye al anuncio más reciente del que provino el cliente.

Si el identificador de clic falta tanto en los parámetros de la función como en las variables de cliente, la función devuelve el error No ctwa_clid variable in client variables y el evento no se envía.