Instancias
Conecta tus números de WhatsApp: cada instancia es un número vinculado por código QR que envía y recibe mensajes para tu cuenta.
Descripción
Una instancia es la conexión entre Chat Digital y un número de WhatsApp. Funciona igual que WhatsApp Web: vinculas tu teléfono una vez con un código QR y, a partir de ahí, la plataforma puede enviar y recibir mensajes de ese número. Puedes tener tantas instancias como permita tu plan (por ejemplo, una para Ventas y otra para Soporte). Solo los administradores pueden crear, iniciar, detener o eliminar instancias; los operadores pueden consultarlas.
Guía de implementación
- Ten a la mano el teléfono con el WhatsApp que vas a conectar
- En Instancias, haz clic en «Nueva instancia» y ponle un nombre (p. ej. Ventas)
- Haz clic en «Iniciar» y espera el código QR
- Escanéalo desde WhatsApp → Dispositivos vinculados → Vincular dispositivo
- Cuando el estado diga «Conectada», envía un mensaje de prueba
Depende de
No requiere configurar otro módulo antes.
Funcionalidades
- Crear, renombrar y eliminar instancias (una por número de WhatsApp)
- Vincular el teléfono escaneando un código QR que se renueva solo
- Ver el estado en tiempo real: Detenida, Iniciando, Esperando QR, Autenticada, Conectada, Desconectada o Con error
- Iniciar y detener una instancia sin volver a escanear el QR
- Desvincular el teléfono para cerrar la sesión de WhatsApp
- Enviar un mensaje de prueba (con archivo opcional) desde el panel
- Verificar si un número tiene WhatsApp antes de escribirle
- Consultar el ID de la instancia que usa la API
Manual de usuario
Crear una instancia #
Crea una instancia por cada número de WhatsApp que quieras conectar. El nombre solo sirve para identificarla dentro del panel; no cambia nada en WhatsApp.
- Paso 1: Entra a Instancias en el menú lateral
- Paso 2: Haz clic en «Nueva instancia»
- Paso 3: Escribe el nombrePor ejemplo «Ventas», «Soporte» o «Sucursal Centro» (máximo 100 caracteres).
- Paso 4: Haz clic en «Crear instancia»La instancia se crea detenida. El siguiente paso es iniciarla y escanear el QR.
Relacionado: Inicio del panel
Vincular tu WhatsApp con el código QR #
- Inicio: IniciarBotón «Iniciar»
- Paso: IniciandoEspera unos segundos
- Paso: Esperando QRAparece el código
- Decisión: EscanearDesde el teléfono
- Paso: AutenticadaTerminando de conectar
- Fin: ConectadaLista para enviar
El código QR se renueva automáticamente. Si tardas en escanearlo, simplemente escanea el más reciente.
Vincular es conectar el teléfono con la instancia. Se hace una sola vez: después puedes detenerla e iniciarla sin volver a escanear.
- Paso 1: En Instancias, haz clic en «Iniciar» en la fila de la instanciaTambién puedes abrirla con «Abrir» y usar «Iniciar» desde el detalle.
- Paso 2: Haz clic en «Ver QR» para abrir el detalleVerás «Iniciando la sesión de WhatsApp… el código QR aparecerá en unos segundos.» y luego el código.
- Paso 3: En tu teléfono abre WhatsApp
- Paso 4: Ve a Configuración → Dispositivos vinculadosEn Android está en el menú ⋮ (tres puntos).
- Paso 5: Toca «Vincular dispositivo» y apunta la cámara al código QR de la pantalla
- Paso 6: Espera a que el estado cambie a «Conectada»Mientras tanto verás «Código escaneado. Terminando de conectar…». Al conectarse aparecen el número y el nombre de la cuenta.
Estados de una instancia #
- Fin: ConectadaTodo bien: puedes enviar y recibir.
- Decisión: Esperando QRAbre el detalle y escanea el código.
- Paso: DetenidaHaz clic en «Iniciar».
- Atención: Desconectada o Con errorRevisa «Último error» y haz clic en «Iniciar». Si pide QR, vuelve a escanear.
Detenida: no está funcionando (no envía ni recibe). Iniciando: se está abriendo la sesión. Esperando QR: hay que escanear el código. Autenticada: el código se escaneó y está terminando de conectar. Conectada: lista para enviar y recibir. Desconectada: perdió la conexión con WhatsApp (por ejemplo, se cerró la sesión desde el teléfono). Con error: no pudo iniciar; el detalle muestra «Último error» con el motivo.
Detener, desvincular o eliminar #
Son tres acciones distintas: detener pausa la instancia sin perder la vinculación; desvincular cierra la sesión de WhatsApp (habrá que escanear otro QR); eliminar borra la instancia del panel.
- Paso 1: «Detener»: pausa la instanciaEl teléfono sigue vinculado; podrás iniciarla de nuevo sin escanear el QR. Mientras esté detenida no enviará ni recibirá mensajes.
- Paso 2: «Desvincular»: cierra la sesión de WhatsAppSolo aparece si hay un número vinculado. Para volver a usarla tendrás que escanear un QR nuevo.
- Paso 3: «Eliminar»: borra la instanciaSe cierra su sesión de WhatsApp. El historial de mensajes se conserva. No se puede deshacer.
Enviar un mensaje de prueba #
En el detalle de la instancia, la tarjeta «Enviar mensaje de prueba» te permite comprobar que todo funciona sin programar nada.
- Paso 1: Abre la instancia desde Instancias → «Abrir»
- Paso 2: En «Para», escribe el número con código de país, solo dígitosEjemplo: 5215512345678. También acepta un chatId (…@c.us o …@g.us para grupos).
- Paso 3: Escribe el «Texto»Hasta 4096 caracteres. Si adjuntas un archivo, el texto se usa como pie.
- Paso 4: Opcional: elige un «Archivo»Máximo 16 MB.
- Paso 5: Opcional: marca «Encolar si está desconectada»Si la instancia no está conectada, el mensaje espera y se envía al conectarse.
- Paso 6: Haz clic en «Enviar»Verás «Mensaje #N» con su estado y un enlace a Mensajes para seguirlo.
Relacionado: Mensajes
Verificar si un número tiene WhatsApp #
La tarjeta «Verificar número» consulta a WhatsApp si un teléfono está registrado. Solo funciona con la instancia conectada.
- Paso 1: En el detalle de la instancia, escribe el número en «Teléfono»
- Paso 2: Haz clic en «Verificar»Verás «+número tiene WhatsApp» con su chatId, o «no está registrado en WhatsApp».
Límites del plan #
Tu plan define cuántas instancias puedes tener y cuántos mensajes puedes enviar al día. Consulta tu consumo en Inicio. El límite diario se reinicia a las 00:00 UTC (18:00 hora del centro de México). Si necesitas más, contacta a Chat Digital para cambiar de plan.
Relacionado: Inicio del panel
Preguntas frecuentes
¿Qué hago si el código QR no aparece?
Espera unos segundos con la pantalla del detalle abierta: primero verás «Iniciando…». Si aparece «No se pudo consultar el estado. Reintentando…», revisa tu conexión. Si la instancia queda «Con error», revisa «Último error» y haz clic en «Iniciar» otra vez.
¿Tengo que dejar el teléfono encendido?
Sí. Como en WhatsApp Web, el teléfono debe tener WhatsApp instalado y conectarse a internet de vez en cuando. Si se cierra la sesión desde el teléfono, la instancia pasa a «Desconectada» y habrá que volver a vincularla.
¿Cuál es la diferencia entre detener y desvincular?
Detener pausa la instancia y conserva la vinculación: al iniciarla vuelve a conectarse sin QR. Desvincular cierra la sesión de WhatsApp: para usarla otra vez hay que escanear un QR nuevo.
¿Por qué no veo los botones «Nueva instancia» o «Iniciar»?
Solo los administradores de la cuenta pueden crear y administrar instancias. Con perfil de operador puedes consultarlas y enviar mensajes de prueba.