Tutorial: CRM - Canales WhatsApp (API no oficial)

Dónde está el CRM

El módulo de Canales WhatsApp se encuentra dentro de la sección Mensajería en el menú lateral izquierdo de Mercasist. Desde ahí puedes gestionar todos tus canales de WhatsApp: crearlos, vincularlos con un número y monitorear su estado.

Menú lateral: Mensajería > Canales WhatsApp

Al ingresar verás la lista de todos tus canales con su estado actual (conectado o desconectado), tipo de API, número de teléfono vinculado y token de autenticación.

Vista general de Canales WhatsApp

Tipos de canales

Mercasist soporta dos tipos de canales de WhatsApp. Antes de crear tu canal, es importante entender las diferencias:

Característica	API oficial (Meta)	API no oficial
Vinculación	Autenticación con Facebook Business	Escaneo de código QR
Riesgo de suspensión	Sin riesgo	Posible suspensión por Meta
Requiere	Cuenta de Facebook Business verificada	Solo un número de WhatsApp
Plantillas de mensaje	Sí (aprobadas por Meta)	No
Reconexión	Automática (no requiere QR)	Requiere escanear QR nuevamente
Desconexiones	Muy poco frecuentes	Pueden ocurrir por cierre de sesión

Nota: Este tutorial cubre la creación de canales con API no oficial (escaneo QR). El uso de la API no oficial puede dar lugar a suspensiones temporales o definitivas del número de WhatsApp por parte de Meta.

Parte 1: Crear un canal con API no oficial

Paso 1 — Haz clic en "Nuevo canal"

En la esquina superior derecha de la página de Canales WhatsApp, haz clic en el botón verde "+ Nuevo canal". Se desplegará un menú con dos opciones.

Dropdown con las opciones: "Con API oficial" y "Con API no oficial"

Paso 2 — Selecciona "Con API no oficial"

Haz clic en la opción "Con API no oficial". Se abrirá un modal donde deberás ingresar el nombre para tu nuevo canal.

Modal de creación: ingresa un nombre descriptivo para el canal

            Nombre del canal: Usa un nombre descriptivo que te ayude a identificar el canal, por ejemplo: "Ventas Principal", "Soporte Técnico", "Pedidos", etc.
        

Costo: Cada canal tiene un costo mensual de 20 USD.

Oferta disponible: Si tu factura mensual de Mercasist supera los 20 USD, el primer canal es de cortesía. Si deseas canales adicionales, cada uno tendrá un costo de 20 USD mensuales.

Paso 3 — Haz clic en "Crear canal"

Una vez que hayas escrito el nombre, presiona el botón "+ Crear canal". El canal se creará con estado Desconectado y aparecerá en tu lista de canales.

Resultado:

El canal aparece en la lista con estado Desconectado
Se muestra el botón QR para vincular tu número
El tipo se identifica como No-Oficial
El teléfono aparece como No vinculado hasta que escanees el QR

Canal recién creado en estado desconectado

Canal creado: estado Desconectado con botón QR visible

Parte 2: Asociar el número escaneando el QR

Paso 1 — Haz clic en el botón "QR"

En la tarjeta del canal desconectado, haz clic en el botón QR que aparece junto al indicador de estado rojo "Desconectado".

Paso 2 — Espera a que se genere el código QR

Se abrirá un modal con el código QR. El sistema puede tardar unos segundos en generarlo. El código se actualiza automáticamente si expira.

Modal del QR: escanea este código con tu WhatsApp

Paso 3 — Escanea el QR desde tu celular

Abre WhatsApp en tu celular y sigue estos pasos:

Ve a Ajustes (o los tres puntos en Android)
Toca "Dispositivos vinculados"
Toca "Vincular un dispositivo"
Escanea el código QR que aparece en la pantalla

            Importante: Debes usar la app de WhatsApp (o WhatsApp Business) del número que deseas vincular al canal. No uses la cámara normal del teléfono.
        

Paso 4 — Espera la confirmación

Después de escanear, el sistema procesará la conexión. El modal se cerrará automáticamente y el canal cambiará su estado a Conectado (verde).

Resultado:

El canal muestra estado Conectado con indicador verde
El número de teléfono vinculado aparece en los detalles del canal
Ya puedes enviar y recibir mensajes a través de este canal

Canal conectado exitosamente con número vinculado

Parte 3: Qué hacer si se desconecta un canal

Un canal puede desconectarse por diversas razones: cierre de sesión desde el teléfono, inactividad prolongada, problemas de red del servidor, o porque otro dispositivo reemplazó la sesión.

Causas comunes de desconexión

Causa	Qué pasó	Solución
Sesión cerrada	Se cerró la sesión desde "Dispositivos vinculados" en el teléfono	Escanear QR nuevamente
Sesión reemplazada	Otro dispositivo o servicio inició sesión con el mismo número	Escanear QR nuevamente
Límite de QR	Se generaron demasiados códigos QR en poco tiempo	Esperar unos minutos y reintentar
Error de inicio	Problema temporal del servidor	Reiniciar el canal y escanear QR

Opción A: Reconectar con QR

Si el canal aparece como Desconectado, el botón QR estará visible. Haz clic en él, escanea el nuevo código desde tu celular (Dispositivos vinculados en WhatsApp) y espera a que el canal vuelva a estado Conectado.

Opción B: Reiniciar el canal

Si el botón QR no funciona o el canal queda en un estado intermedio, puedes reiniciar el canal desde el menú de opciones:

Haz clic en el icono de tres puntos verticales en la esquina derecha de la tarjeta del canal.
Selecciona "Reiniciar". El sistema reiniciará la instancia del canal en el servidor.
Después del reinicio, haz clic en el botón QR y escanea el código con tu celular para reconectar.

Menú de opciones: Editar nombre, Webhooks, Configurar IA, Reiniciar y Eliminar canal

            Alerta por correo: Si un canal lleva desconectado mucho tiempo, Mercasist te enviará un correo electrónico con el asunto "Acción Requerida: Reconectar Canal de WhatsApp" para recordarte que debes reconectarlo.
        

Estados de un canal

Los canales pueden tener los siguientes estados:

Estado	Color	Significado
Conectado	Verde	El canal está activo y puede enviar/recibir mensajes
Desconectado	Rojo	El canal perdió la conexión. Necesita escanear QR nuevamente
Reconectando	Amarillo	El sistema está intentando reconectar automáticamente

Puntos de interés

No cierres la sesión desde el teléfono

Si vas a "Dispositivos vinculados" en WhatsApp y cierras la sesión de Mercasist, el canal se desconectará y deberás escanear el QR nuevamente.

Un número = un canal

Cada número de WhatsApp solo puede estar vinculado a un canal a la vez. Si necesitas vincular el mismo número a otro canal, primero deberás desvincularlo del canal actual.

WhatsApp Business recomendado

Se recomienda usar la app de WhatsApp Business en lugar de WhatsApp regular para vincular canales comerciales, ya que ofrece funciones adicionales como catálogo y respuestas rápidas.

Límite de QR

Si ves el mensaje "Límite de QR alcanzado", espera unos minutos antes de intentar generar un nuevo código. Esto ocurre cuando se solicitan demasiados códigos en poco tiempo.