🤖 Integración de MikroWisp con CRMInbox | Guía paso a paso - CRMInbox

Configurar plantillas de MikroWisp ✅

Configurar plantillas de MikroWisp — Guía CRMInbox
⚙️
CRMInbox · MikroWisp — Guía práctica
Configurar plantillas de MikroWisp
Sigue estos pasos para instalar tus plantillas, esperar la aprobación de Meta y conectarlas con MikroWisp.
🎯 ¿Qué vas a hacer?

Instalarás una plantilla, la vincularás al número de WhatsApp correcto y configurarás MikroWisp para enviar un mensaje de prueba.

✅ Antes de empezar
🔐
Acceso a CRMInbox y MikroWisp con permiso para cambiar la configuración.
📱
Un número de WhatsApp Business agregado a CRMInbox.
🧩
Los datos de conexión de CRMInbox (dominio y API Key). Los necesitarás en el paso 5.
ℹ️ Antes de usar una plantilla: Meta debe aprobarla. PENDING significa «En revisión» y APPROVED significa «Aprobada».
Instalación y configuración paso a paso
1
Filtrar las plantillas en CRMInbox

Abre Plantillas de Flujos en CRMInbox y aplica el filtro para encontrar las plantillas.

  1. Abre Plantillas de Flujos.
  2. En el filtro Tipo, selecciona Plantilla.
  3. Haz clic en el botón de búsqueda.
CRMInbox con el filtro Tipo configurado como Plantilla
✅ Resultado esperado: el Store muestra los productos cuyo tipo es Plantilla.
2
Identificar las plantillas de MikroWISP

Busca en el Store la plantilla que quieras instalar. Estas son las tres opciones de MikroWISP:

1. Bienvenida de Cliente - MikroWISP
2. Suspensión de Servicio - MikroWISP
3. Recordatorio de Pago - MikroWISP

Selecciona Ver Detalles en la plantilla que elegiste. Repite estos pasos para cada plantilla que quieras instalar.

Tres plantillas de MikroWISP disponibles en el Store de CRMInbox
3
Instalar la plantilla en un dispositivo
  1. Haz clic en Instalar plantilla.
  2. En el selector, elige el número de WhatsApp Business donde quieres usarla.
  3. Si tienes varios números, selecciona el correcto. Si solo tienes uno, selecciónalo y continúa.
Ventana Instalar plantilla con el selector de dispositivo de WhatsApp Business
ℹ️ Al instalarla, CRMInbox la envía a Meta para que la revise.
4
Verificar la revisión de Meta

En CRMInbox, abre:

Configuración → Plantillas de Meta
  1. Selecciona el mismo número de WhatsApp Business que elegiste al instalarla.
  2. Busca la plantilla. Debe aparecer como PENDING (En revisión).
Plantilla de Meta con estado PENDING durante la revisión
⏳ Espera a que se apruebe: Meta revisa la plantilla según su categoría (Utilidad, Marketing o Autenticación). La revisión suele tardar entre 2 horas y 1 día, aunque el tiempo puede variar. Continúa cuando veas APPROVED (Aprobada).
5
Configurar el Gateway genérico en MikroWisp

Una vez aprobada la plantilla, entra en MikroWisp a:

Ajustes → Mensajería → Gateway genérico

Completa los campos con los datos de conexión de tu cuenta de CRMInbox. Reemplaza TU_DOMINIO y TU_API_KEY por los valores que te proporcionaron.

CampoValor
URL Gatewayhttps://TU_DOMINIO.crminbox.io/api/mikrowisp/messages/
Parámetrosto={destinatario}&message={mensaje}
MétodoPOST
Token Authorization BearerApi-Key TU_API_KEY
Límite de caracteres3000
Pausa entre mensajes0
Configuración del Gateway genérico en MikroWisp
✅ Al terminar: guarda la configuración. MikroWisp ya tendrá los datos para conectarse con CRMInbox.
6
Consultar el ID del número en CRMInbox

Antes de configurar las plantillas, identifica el ID del número desde el que quieres enviar los mensajes:

  1. En CRMInbox, abre Configuración → Teléfonos.
  2. Busca en la lista el número que seleccionaste al instalar la plantilla.
  3. Copia el ID que aparece en la primera columna de esa misma fila.
Lista de teléfonos en CRMInbox y sus ID
ℹ️ También necesitarás el nombre de la plantilla. En el paso 4, revisa la captura de Plantillas de Meta y copia el nombre que aparece en la columna Nombre. Si creaste una plantilla nueva, cópialo exactamente como se muestra, incluidos los guiones bajos.
✅ Usa este ID al inicio de la cadena de MikroWisp. Debe corresponder al mismo número de WhatsApp que elegiste al instalar la plantilla.
7
Configurar las plantillas en MikroWisp

En MikroWisp, abre Ajustes → Editor de plantillas → Plantillas SMS/Telegram y pega allí la cadena correspondiente.

ℹ️ Una variable completa automáticamente un dato del cliente. Escríbela así: [{nombre_cliente}]. Para un dato fijo, como una dirección web, usa una sola pareja de corchetes: [https://ejemplo.com].
Sustituye el número al inicio de cada ejemplo por el ID que consultaste en el paso 6. Conserva el nombre exacto de la plantilla y el orden de los datos.
Recordatorio de pago — recordatorio_pago_mk

En esta plantilla de Meta, cada número entre llaves dobles se sustituye por un dato del cliente:

Vista previa corregida de la plantilla de recordatorio de pago en Meta
Variable de MetaDato que recibirá el clienteVariable de MikroWisp
{{1}}Nombre del cliente[{nombre_cliente}]
{{2}}Monto pendiente[{deuda_cliente}]
{{3}}Fecha de vencimiento de la factura[{diapago_cliente}]

Con el ID 5 del dispositivo, la cadena que debes colocar en MikroWisp es:

5|recordatorio_pago_mk|[{nombre_cliente}],[{deuda_cliente}],[{diapago_cliente}]
Aviso de suspensión — suspension_servicio_mk

En esta plantilla de Meta, cada número entre llaves dobles se sustituye por un dato del cliente:

Vista previa de la plantilla de aviso de suspensión en Meta
Variable de MetaDato que recibirá el clienteVariable de MikroWisp
{{1}}Nombre del cliente[{nombre_cliente}]
{{2}}Saldo pendiente[{deuda_cliente}]

Con el ID 5 del número PRUEBAS, la cadena que debes colocar en MikroWisp es:

5|suspension_servicio_mk|[{nombre_cliente}],[{deuda_cliente}]
Bienvenida de cliente — bienvenida_cliente_mk

Esta plantilla de Meta tiene una sola variable. {{1}} se reemplaza por el nombre del cliente:

Vista previa de la plantilla de bienvenida de cliente en Meta
Variable de MetaDato que recibirá el clienteVariable de MikroWisp
{{1}}Nombre del cliente[{nombre_cliente}]

Con el ID 5 del número PRUEBAS, la nomenclatura para MikroWisp queda así:

5|bienvenida_cliente_mk|[{nombre_cliente}]
Editor de plantillas SMS y Telegram en MikroWisp
Lista de plantillas SMS y Telegram disponibles en MikroWisp
{ }
Variables disponibles para nuevas plantillas
Consulta rápida para relacionar las variables de Meta con los datos de MikroWisp.
Si deseas crear una plantilla nueva, utiliza únicamente las variables de esta lista. Son las únicas que hemos comprobado que funcionan en la integración. Asígnalas respetando el orden de {{1}}, {{2}}, {{3}}… en la plantilla de Meta.
1. Identificación y estado del cliente
ID del cliente
[{id_cliente}]
Nombre del cliente
[{nombre_cliente}]
Estado del cliente
[{estado_cliente}]
Cédula del cliente
[{cedula_cliente}]
Código del cliente
[{codigo_cliente}]
2. Contacto y ubicación
Correo del cliente
[{correo_cliente}]
Teléfono del cliente
[{telefono_cliente}]
Móvil del cliente
[{movil_cliente}]
Dirección principal
[{direccion_principal_cliente}]
Ubicación del cliente
[{ubicacion_cliente}]
3. Pago y facturación
Pasarela del cliente
[{pasarela_cliente}]
Día de pago o vencimiento
[{diapago_cliente}]
Deuda pendiente
[{deuda_cliente}]
⚠️
Importante: [{deuda_cliente}] se utiliza únicamente en recordatorios o avisos previos al pago. Cuando la factura ya fue pagada, el monto pendiente deja de estar disponible.
⚙️
Generador de nomenclatura
Completa los datos y agrega las variables en el mismo orden en que aparecen en tu mensaje de Meta.
Ejemplo: la variable que corresponde a {{1}} debe agregarse primero; la de {{2}}, en segundo lugar, y así sucesivamente.
1. Datos de la plantilla
2. Variables en el orden del mensaje

Selecciona una variable y agrégala. Después podrás subirla, bajarla o quitarla.

Aún no has agregado variables.
3. Nomenclatura generada
Completa el ID, el nombre de la plantilla y agrega al menos una variable.
8
Realizar una prueba manual

Envía un mensaje de prueba antes de activar los envíos automáticos. Aunque MikroWisp muestre el botón Enviar SMS, el Gateway usará la plantilla de WhatsApp que configuraste.

  1. Abre Clientes → Usuarios.
  2. Elige un usuario de prueba con un número al que tengas acceso.
  3. Abre las acciones de ese usuario y selecciona Enviar SMS.
  4. Pega la cadena de la plantilla que configuraste y envíala.
Ejemplo de recordatorio
5|recordatorio_pago_mk|[{nombre_cliente}],[{deuda_cliente}],[{diapago_cliente}]
✅ Comprueba que el mensaje muestre los datos correctos y llegue al número de prueba antes de activar los envíos automáticos.
Envío manual de un mensaje desde MikroWisp
Ventana para escribir y enviar un SMS desde la lista de usuarios de MikroWisp
9
Revisar el historial de envíos

Para consultar cómo MikroWisp registró el envío, abre:

Mensajería → Mensajes enviados

Puedes revisar la fecha, el número al que se envió y el estado registrado. Este historial muestra el procesamiento en MikroWisp; por sí solo no confirma que el destinatario haya recibido el mensaje.

Historial de mensajes enviados de MikroWisp
10
Confirmar el envío en CRMInbox

Después de enviar la plantilla, puedes revisar en CRMInbox que la notificación se haya procesado por medio de la API:

  1. Abre la opción Chat. Si tienes varios números, selecciona el número desde el cual enviaste la plantilla.
  2. En la barra que aparece arriba de los nombres de las conversaciones, selecciona Notificaciones.
  3. Abre la conversación correspondiente y verifica que el mensaje muestre “Notificación | Enviada por medio del API”.
Confirmación: este aviso indica que CRMInbox procesó el envío mediante la API. No confirma por sí solo que el destinatario haya recibido o leído el mensaje.
Chat de CRMInbox con la pestaña Notificaciones seleccionada y el aviso Enviada por medio del API
🧭 Preguntas frecuentes
¿No encuentras la plantilla?
Confirma que elegiste el número de WhatsApp en el que instalaste la plantilla.
¿La plantilla sigue “En revisión”?
Meta aún está revisándola. Espera hasta que su estado cambie a “Aprobada”.
¿Un dato no aparece en el mensaje?
Revisa que las variables y su orden coincidan con el ejemplo. Si el problema continúa, consulta con tu administrador qué variables están disponibles en tu cuenta.
¿Debes incluir el saldo en una confirmación de pago?
No. Después de que el cliente paga, el saldo deja de aparecer como pendiente; por eso, no agregues esa variable a una plantilla de confirmación.

23 de Abril de 2026 a las 17:39 - Visitas: 2959