Saltar al contenido principal

[Extensión] Cómo enviar mensajes activos de WhatsApp desde Smartico

  • Actualización

  1. Introducción

  2. Funcionalidades

  3. Requisitos previos

  4. Instalación y configuración

  5. Ejemplo de uso

  6. Soporte

 

Descripción breve: Conecta las reglas de automatización de Smartico con Blip y envía mensajes de WhatsApp con plantillas aprobadas, rellenadas con los datos que Smartico envía mediante webhook.

 

Introducción

La extensión Smartico (iGaming): Envío de mensajes integra la plataforma de automatización Smartico con Blip para enviar mensajes activos de WhatsApp. Cuando se activa una regla de automatización en Smartico, esta llama mediante webhook a una URL generada por la extensión, y Blip envía una plantilla de WhatsApp aprobada, ya rellenada con los datos recibidos.

Por ejemplo, al crear una regla que se active después de que un jugador realice un depósito, Smartico envía el número del jugador y los datos del depósito a la URL de la extensión. La extensión localiza estos valores en el cuerpo de la solicitud, rellena las variables de la plantilla y envía el mensaje al WhatsApp del jugador.

 

Funcionalidades

  • Enviar mensajes de WhatsApp a partir de las reglas de automatización de Smartico mediante webhook.

  • Enviar plantillas de WhatsApp ya aprobadas en el bot.

  • Rellenar las variables de la plantilla con los datos enviados en el cuerpo del webhook mediante la referencia [body.campo].

  • Rellenar variables de medios y botones cuando la plantilla lo requiera.

  • Colocar al contacto en un bot y flujo específicos después del envío.

Compatible con el siguiente canal: WhatsApp.

 

Requisitos previos

  • Un bot Enrutador en Blip con el canal de WhatsApp conectado, que será el remitente de los mensajes.

  • Al menos una plantilla de WhatsApp aprobada en ese bot.

  • Acceso al módulo de Reglas de automatización (Automation Rules) de Smartico.

  • El número de cada destinatario en formato internacional, con el signo +, código de país, código de área y número (por ejemplo, +5511999999999).

 

Instalación y configuración

Instalar la extensión

  1. Abre la página de Smartico en Blip Store y haz clic en Iniciar prueba gratis.

Página da extensão Smartico na Blip Store com o botão Iniciar teste grátis

  1. Instala la extensión en tu bot y ábrela. Se abrirá el asistente de configuración en tres etapas: Configurar bot, Configurar plantilla e Instalar automatización. No hay un paso de autenticación: toda la configuración se realiza en el asistente.

Assistente de configuração da extensão Smartico com as etapas Configurar bot, Configurar template e Instalar automação

Configurar el bot que envía los mensajes

En la etapa Configurar bot, selecciona en Bot enrutador principal con WhatsApp conectado el Enrutador que tiene WhatsApp conectado y haz clic en Guardar y continuar. La extensión empezará a usar el WhatsApp de este bot para enviar los mensajes. Si aparece el aviso Whatsapp no reconocido en este bot, el bot seleccionado no tiene WhatsApp conectado y debes elegir otro.

Configurar la plantilla y las variables

  1. En la etapa Configurar plantilla, abre Modelo de mensaje y selecciona la plantilla aprobada que se usará para el envío. La extensión muestra el cuerpo del mensaje para que lo revises.

Etapa Configurar template com o campo Modelo de mensagem e o corpo do template selecionado

  1. Para cada variable de la plantilla (Variable {{1}}, Variable {{2}} y así sucesivamente), indica el valor que la rellenará. Para usar un dato dinámico enviado por Smartico, escribe la referencia [body.campo], donde campo es el nombre exacto del campo enviado en el cuerpo del webhook. Por ejemplo, [body.name] busca el valor del campo name en el cuerpo de la solicitud.

  2. Si la plantilla incluye medios o un botón, rellena los campos Enlace del medio y Botón de la variable.

  3. Para colocar al contacto en un bot y flujo después de recibir el mensaje, activa Colocar usuario en el bot y elige el Bot y el Flujo de destino. Este paso es opcional.

Nota: la cantidad de campos de variables depende de la plantilla seleccionada. Si cambias la plantilla después o modificas la cantidad de variables, vuelve a realizar la configuración y genera una nueva URL para que los campos sigan correspondiendo.

Variables dinámicas de Smartico

Las variables dinámicas corresponden a los datos que creas en el campo Data de las Reglas de automatización de Smartico. Cada dato enviado en el cuerpo del webhook se convierte en un campo al que la extensión puede acceder mediante [body.nombreDeLaVariable]. Crea en Smartico los datos que necesita el mensaje, por ejemplo:

Campo Data das Regras de Automação do Smartico com as variáveis do disparo em formato JSON

En la extensión, referencia cada dato en el campo de la variable correspondiente. Los nombres deben ser idénticos a los campos enviados por Smartico:

[body.name] [body.orderNumber] [body.deliveryDate]

Campos de variável da extensão preenchidos com as referências [body.campo] correspondentes

Generar y copiar la URL de integración

Después de configurar la plantilla y las variables, la extensión genera automáticamente la URL de integración. Copia la URL y guárdala para el siguiente paso.

URL de integração gerada pela extensão, pronta para copiar

Atención: la URL contiene la clave de acceso de la extensión. No la compartas en lugares públicos ni modifiques sus parámetros manualmente, ya que quien tenga la URL puede enviar mensajes mediante tu bot.

Configurar el webhook en Smartico

En el módulo de Reglas de automatización de Smartico:

  1. Abre las Reglas de automatización y agrega una actividad de tipo Webhook.

  2. Pega la URL generada por la extensión en el campo Webhook URL.

  3. Selecciona el método POST.

  4. Define Content-Type como application/json.

  5. En el campo Data, crea las variables utilizadas en el mensaje y un campo obligatorio phoneNumber con el número que recibirá el mensaje, en formato internacional.

Configuração da atividade de webhook no Smartico com a URL, o método POST e o Content-Type application/json

Campo obligatorio phoneNumber

El campo phoneNumber es obligatorio en todos los envíos e identifica el número que recibirá el mensaje. Si no se incluye en el cuerpo del webhook, la extensión rechaza la solicitud; si el número no es válido, el envío también falla. Envía el número en formato internacional, con +, código de país, código de área y número:

Las demás variables (name, orderNumber, deliveryDate) rellenan el texto de la plantilla.

Campo Data do Smartico com o campo obrigatório phoneNumber e as demais variáveis do template

 

Ejemplo de uso

Considera una plantilla con tres variables:

Hola, {{1}}. Tu pedido {{2}} tiene una entrega programada para {{3}}.

En el campo Data de Smartico:

En la extensión, asigna cada variable al campo correspondiente:

  • {{1}} recibe [body.name]

  • {{2}} recibe [body.orderNumber]

  • {{3}} recibe [body.deliveryDate]

El contacto recibe en WhatsApp:

Hola, Juan Silva. Tu pedido 12345 tiene una entrega programada para el 10/09/2024.

Antes de activar campañas más grandes, realiza una prueba con un número controlado y confirma que el mensaje llegue a WhatsApp. Si no llega, revisa la URL, el método POST, el Content-Type y el campo phoneNumber. Supervisa las respuestas y los errores de las primeras ejecuciones antes de habilitar el envío masivo.

 

Soporte

Si tienes dudas o problemas con la extensión, contáctanos por correo electrónico en support@wiv.com.br.


 

¿Necesitas más ayuda? Explora nuestros contenidos en Blip Academy o Blip Community, mira tutoriales en nuestro canal de YouTube o resuelve tus dudas en nuestro canal de atención 😃

Artículos relacionados