Conexiones de WhatsApp
Cómo vincular los números de WhatsApp del proveedor de internet a ChatISP: por la aplicación leyendo un código QR, por la API oficial de Meta o por las dos al mismo tiempo en el mismo número. Esta página explica cada camino paso a paso, la ventana de 24 horas y las plantillas aprobadas, la franquicia de mensajes de Meta, la restricción de conexiones por agente y lo que sucede con el historial cuando se retira una conexión.
Visión general
Una conexión es un número de WhatsApp vinculado a ChatISP. Todo lo que llega a ese número se convierte en conversación en el panel de atención, y todo lo que el equipo, la IA o los flujos responden sale por él. La pantalla está en el menú Conexiones, con el subtítulo Números de WhatsApp conectados al sistema, por QR o por la API oficial.
Existen dos transportes, que pueden usarse por separado o juntos en el mismo número:
| Transporte | Cómo funciona | Costo de los mensajes |
|---|---|---|
| Aplicación (código QR) | ChatISP entra como un dispositivo vinculado al WhatsApp del teléfono, de la misma forma que WhatsApp Web. El teléfono conserva el número y la aplicación. | Sin costo por mensaje. |
| API oficial | El número se vincula a la plataforma oficial de Meta (WhatsApp Business, Cloud API). Ofrece menús con botones, plantillas aprobadas, tarjeta de cobro con botones de copiar y llamadas por el canal oficial. | Meta cobra por mensaje, con una franquicia mensual gratuita por número. Vea Franquicia y costos. |
Cuando el mismo número está conectado por los dos transportes, ChatISP trata el par como un solo canal: una conversación por cliente, mensajes sin duplicados y la salida elegida según la política que defina el administrador. Detalles en QR y API oficial en el mismo número.
Quién puede usarla
La pantalla requiere el permiso Conexiones de WhatsApp (descripción en la pantalla de perfiles: Conecta y gestiona los números de WhatsApp del sistema.). Quien no tiene el permiso no ve el menú. Para definir en qué números trabaja cada agente, vea Conexiones por agente.
Límite de números por plan Límite por plan
El plan contratado define cuántos números de WhatsApp puede tener la instalación. El conteo se hace por número: un número conectado por QR y por la API oficial al mismo tiempo ocupa un solo cupo. En el encabezado de la pantalla aparece el medidor con el formato 2 de 4 números de WhatsApp de su plan; cuando se alcanza el tope, cambia a Límite del plan alcanzado y el botón Nueva conexión deja de aparecer.
| Plan | Números de WhatsApp |
|---|---|
| BASIC | 1 |
| NORMAL | 2 |
| PREMIUM | 4 |
| GOLD | 8 |
| ENTERPRISE | Sin límite |
| Prueba gratuita | Sin límite durante el período de prueba |
Los límites no son retroactivos: si el plan se reduce, no se elimina ninguna conexión. El sistema solo deja de aceptar números nuevos hasta que el total vuelva a caber en el plan.
Cómo está organizada la pantalla
Cada número aparece en un bloque. Un número con un solo transporte aparece en el bloque Conexión individual (Un canal de atención para este número.). Un número con QR y API oficial aparece en el bloque Conexiones vinculadas (Código QR y API oficial, un número y la misma conversación.), con el teléfono destacado y las dos tarjetas lado a lado, la del QR primero.
Cada tarjeta muestra el nombre que usted le dio a la conexión, la etiqueta de estado, el tipo (Aplicación (código QR) o API oficial), el teléfono, el nombre de la cuenta de WhatsApp (o Sin nombre) y los botones de acción. La pantalla se actualiza sola cada 10 segundos, de modo que una desconexión hecha desde el teléfono aparece sin necesidad de recargar.
Elegir el tipo de conexión
Haga clic en Nueva conexión. La ventana pregunta Elija cómo quiere conectar WhatsApp: y ofrece cuatro caminos:
| Opción en la pantalla | Cuándo usarla |
|---|---|
| API oficial de WhatsApp Recomendado | Conecte en pocos clics, con configuración automática. Para un número dedicado a la atención, que no esté en uso en el WhatsApp de un teléfono. Vea API oficial de Meta. |
| Número Business existente Coexistencia | Lleve a la API oficial el número que ya usa en la aplicación WhatsApp Business, sin perder la aplicación. Vea Coexistencia. |
| Aplicación (código QR) | Conexión por la aplicación, leyendo un código QR. El camino más rápido para empezar. Vea Conectar por código QR. |
| Configuración manual | Para quien ya tiene las credenciales de Meta a mano. Vea Configuración manual. |
¿Código QR o API oficial?
| Aspecto | Aplicación (código QR) | API oficial |
|---|---|---|
| El número sigue en el teléfono | Sí, el teléfono sigue usando WhatsApp normalmente. | No, en el número dedicado. Sí, en la coexistencia con WhatsApp Business. |
| Costo por mensaje | Ninguno. | Cobrado por Meta, con franquicia mensual gratuita por número. |
| Iniciar una conversación en cualquier momento | Sí, con texto libre. | Solo dentro de la ventana de 24 horas; fuera de ella, únicamente con plantilla aprobada. |
| Menús de los flujos | Texto numerado. | Botones y listas interactivas. |
| Factura con botones de copiar Pix y boleto | Sí, cuando está activado en Configuración: botones de la propia aplicación, sin costo. | Sí, cuando está configurado. |
| Editar, eliminar para todos y reaccionar | Sí. | Los recursos disponibles siguen lo que Meta ofrece en el canal oficial. |
| Foto y nombre del contacto | Sí, provenientes de WhatsApp. | Según lo que envíe Meta. |
| Depende del teléfono encendido | El teléfono debe seguir con el número activo y con internet; si el dispositivo se elimina en el teléfono, la conexión se cae. | No. |
No es necesario elegir un solo lado. ChatISP fue hecho para funcionar igual con solo QR, solo API oficial o los dos juntos en el mismo número. Muchos proveedores empiezan por el QR y después agregan la API oficial en el mismo número para obtener los menús con botones y la tarjeta de cobro.
Conectar por código QR
ChatISP se convierte en un dispositivo vinculado del WhatsApp del número, como WhatsApp Web. Sirve tanto para WhatsApp común como para WhatsApp Business.
- En Conexiones, haga clic en Nueva conexión y elija Aplicación (código QR). La conexión se crea con el nombre WhatsApp (puede renombrarla después en Editar) y la ventana Conectar WhatsApp se abre sola.
- Espere a que aparezca el código. La ventana muestra Esperando la lectura del código...
- En el teléfono del número, abra WhatsApp, toque Dispositivos vinculados (en Configuración o en el menú de tres puntos, según el dispositivo), luego en vincular un dispositivo, y apunte la cámara al código de la pantalla.
- Cuando se acepta la lectura, aparece WhatsApp conectado con éxito., la ventana se cierra y la tarjeta pasa a Conectada, ya con el teléfono y el nombre de la cuenta.
El código de WhatsApp expira en poco tiempo. Si nadie lo lee a tiempo, la ventana muestra El código expiró. Genere uno nuevo para continuar. y el botón Generar nuevo código. No es necesario cerrar la ventana: haga clic en el botón y lea el nuevo código.
Una conexión QR existente que está desconectada tiene el botón Conectar en la tarjeta, que abre la misma ventana de lectura.
Qué sucede al conectar
- Los mensajes que lleguen al número pasan a entrar en ChatISP y siguen las reglas de atención (flujos, IA, cola y departamentos).
- El sistema verifica si ya existe una conexión de la API oficial con el mismo teléfono. Si existe, las dos se convierten en Conexiones vinculadas automáticamente.
- Si el número ya atendió antes por otra conexión que fue eliminada, las conversaciones antiguas de ese número vuelven a quedar vinculadas a él, abiertas y finalizadas. Vea Desconectar, eliminar y reconectar.
- Si el nombre de la cuenta todavía no llegó de WhatsApp en la primera lectura, el panel vuelve a consultar solo y completa la tarjeta.
El teléfono sigue funcionando normalmente. Los mensajes respondidos desde el teléfono también aparecen en la conversación del panel, para que el equipo vea todo lo que se le dijo al cliente.
Servidor sin acceso a WhatsApp
Si al solicitar el código aparece El servidor no pudo comunicarse con WhatsApp. Verifique la salida del servidor a internet e intente de nuevo., el problema es de red, no del panel: el servidor no logra salir a internet hasta los servidores de WhatsApp (firewall, ruta o DNS del proveedor). Libere la salida del servidor y use Generar nuevo código.
API oficial de Meta
La opción API oficial de WhatsApp conecta un número dedicado a la plataforma oficial de Meta mediante un asistente con inicio de sesión de Facebook. No es necesario copiar identificadores ni tokens: el asistente busca las cuentas, usted elige el número y ChatISP configura el resto, incluida la recepción de los mensajes.
Requisitos del número
Antes de abrir el asistente, la pantalla muestra Requisitos de la API oficial con el aviso Necesita un número dedicado, que no esté en uso en el WhatsApp del teléfono.
| Qué funciona | Qué no funciona |
|---|---|
| Chip o eSIM dedicado | Número ya en uso en el WhatsApp del teléfono |
| Línea fija, con verificación por llamada | Números virtuales, que generalmente no verifican |
| Número empresarial fuera de WhatsApp |
El botón Continuar con Facebook solo se habilita después de marcar Tengo un número dedicado que no está en uso en el WhatsApp del teléfono. Si el número ya está en la aplicación WhatsApp Business y usted quiere mantenerlo allí, use la coexistencia.
Paso a paso del asistente
El asistente Conectar WhatsApp Business tiene cuatro etapas, indicadas en la parte superior: Entrar, Autorizar, Elegir número y Listo.
- Haga clic en Continuar con Facebook. Se abre una nueva pestaña con la página segura de conexión de Ravi Systems. El panel avisa: Abrimos una pestaña segura de Ravi Systems para que inicie sesión con Facebook. Termine la autorización allí: en cuanto acabe, este asistente continúa solo. Si el navegador bloquea la pestaña, use el botón Abrir la página de conexión.
- En la pestaña nueva, inicie sesión con el Facebook de quien administra la empresa en el Administrador comercial de Meta y siga las pantallas de Meta: elegir o crear el portafolio de la empresa, la cuenta de WhatsApp Business y el número, y confirmar el número.
- Al terminar en la pestaña, vuelva a ChatISP. El asistente detecta la autorización solo, muestra Buscando sus cuentas de WhatsApp Business... y lista las cuentas y los números encontrados, cada número con el sello de calidad de Meta.
- Haga clic en el número deseado y en Conectar número seleccionado. El panel muestra Configurando la conexión..., crea la conexión, activa la recepción de mensajes en la cuenta comercial y termina con ¡WhatsApp conectado!.
La autorización debe completarse en un máximo de 5 minutos después de abrir la pestaña. Pasado ese plazo, el asistente muestra La autorización no se completó a tiempo. Inténtelo de nuevo. y el botón Intentar de nuevo.
¿Por qué una pestaña de Ravi Systems? Meta solo permite el inicio de sesión de conexión en páginas de direcciones aprobadas previamente, y la mayoría de las instalaciones no tiene dominio propio. La página central solo hace el inicio de sesión; el intercambio de la autorización por las credenciales ocurre dentro de su propio ChatISP, y la página central no guarda las credenciales de su número.
Mensajes de error del asistente
| Mensaje | Qué significa |
|---|---|
| La autorización fue cancelada. | La ventana de Facebook se cerró o el inicio de sesión fue rechazado antes del final. |
| No se encontró ningún número de WhatsApp Business. Termine la configuración en el panel de Meta e intente de nuevo. | La autorización se realizó, pero la cuenta no tiene ningún número listo. Termine el registro y la verificación del número en Meta. |
| No se permiten números de prueba. Registre un número real para usar la API oficial. | El número elegido es el número de prueba que Meta crea para desarrolladores. |
| Este número ya está conectado. | Ya existe una conexión de la API oficial con ese número en esta instalación. |
| No fue posible cargar Facebook. Verifique internet e intente de nuevo. | El servidor no logró iniciar la conexión con la página central o la integración con Meta no está disponible en esta instalación. Verifique la salida del servidor a internet; si persiste, contacte al soporte de Ravi Systems. |
Recepción de los mensajes (webhook)
En la API oficial, los mensajes de los clientes llegan porque Meta llama a una dirección de su ChatISP (la Dirección del webhook, visible en la ventana Configurar API). El asistente suscribe esa dirección en la cuenta comercial automáticamente. Para que funcione, Meta debe poder alcanzar esa dirección por internet, con HTTPS y un certificado válido.
- Instalación propia Configure un dominio con certificado para el servidor (vea la página Servidor) antes de conectar la API oficial. Un servidor accesible solo desde la red interna envía mensajes, pero no los recibe.
- En ChatISP Cloud, Ravi Systems ya proporciona la dirección pública; no hay nada que configurar.
Si la suscripción de la recepción falla al final del asistente, el asistente muestra el motivo devuelto por Meta y la tarjeta de la conexión queda en Configuración pendiente. Corrija la causa (normalmente la dirección pública del servidor) y use Configurar API y Guardar para intentar la suscripción de nuevo.
Número Business existente (coexistencia)
La coexistencia es el recurso de Meta que lleva a la API oficial un número que ya está en la aplicación WhatsApp Business, sin quitar el número del teléfono. La aplicación sigue funcionando y ChatISP pasa a comunicarse por el canal oficial del mismo número.
| Cómo funciona | Requisitos del número |
|---|---|
| Use el número que ya está en la aplicación WhatsApp Business | Aplicación WhatsApp Business actualizada |
| Usted sigue usando la aplicación normalmente | Número activo en la aplicación desde hace al menos 7 días |
| La confirmación se hace con un código QR leído en la propia aplicación |
- En Nueva conexión, elija Número Business existente.
- Marque Tengo el número en la aplicación WhatsApp Business y el teléfono a mano y haga clic en Continuar con Facebook.
- En la pestaña de Ravi Systems, inicie sesión con Facebook y siga las pantallas de Meta. En uno de los pasos, Meta muestra un código QR: léalo en la propia aplicación WhatsApp Business del teléfono, como indique la pantalla de Meta.
- Completada la autorización, ChatISP normalmente ya recibe el número elegido y finaliza solo. Si no lo recibe, muestra la lista de cuentas para que usted elija el número, como en el flujo común.
Para tener lo mejor de los dos mundos en el mismo número, conecte también el código QR de ese número (opción Aplicación (código QR), leyendo el código en el mismo teléfono). Las dos conexiones se convierten en Conexiones vinculadas y ChatISP pasa a elegir el canal de cada mensaje según la política de costos. Vea QR y API oficial en el mismo número.
En un número con coexistencia, las llamadas de voz del canal oficial no están disponibles: Meta solo habilita llamadas por el canal oficial en un número dedicado, sin la aplicación. La tarjeta muestra Llamadas no disponibles con la explicación. Para llamadas en ese número, use la vía QR (vea Llamadas de voz y video).
Configuración manual de la API oficial
Para quien ya tiene una aplicación y las credenciales de Meta (por ejemplo, un número ya operado por otro sistema), la opción Configuración manual crea una conexión de la API oficial llamada WhatsApp Business y abre la ventana Configurar API. La misma ventana se abre con el botón Configurar API en la tarjeta de cualquier conexión de la API oficial.
| Campo | Qué informar |
|---|---|
| Identificación del número | El identificador del número de teléfono en la plataforma de Meta (el "phone number ID", no el teléfono). Obligatorio. |
| Identificación de la cuenta comercial | El identificador de la cuenta de WhatsApp Business (WABA). Con este campo completo, el sistema activa la recepción solo y habilita el botón Plantillas. |
| Token de acceso | El token permanente con permiso sobre la cuenta. Se guarda cifrado. Al editar, déjelo en blanco para mantener el token actual. |
| Dirección del webhook | Solo lectura. Es la dirección de su ChatISP a la que Meta llama para entregar los mensajes. |
| Token de verificación del webhook | Solo lectura, generado por el sistema. Use este valor si necesita configurar el webhook a mano en el panel de Meta. |
Al hacer clic en Guardar, ChatISP prueba las credenciales al instante y, si el token funciona, suscribe la recepción en la cuenta comercial. Los avisos posibles:
| Aviso | Qué hacer |
|---|---|
| Conexión con la API oficial confirmada. | Todo correcto: la tarjeta pasa a Conectada con el teléfono y el nombre de la cuenta. |
| No fue posible confirmar la conexión. Verifique las credenciales. | Meta rechazó el identificador o el token. La tarjeta queda en Configuración pendiente. |
| La conexión envía, pero no va a recibir: no fue posible activar la recepción en la cuenta comercial. Verifique si el token tiene permiso sobre ella. | El token envía mensajes, pero no tiene permiso para suscribir el webhook en la cuenta comercial, o Meta no alcanzó la dirección del webhook. Ajuste los permisos del token o la dirección pública del servidor. |
| Sin la identificación de la cuenta comercial la recepción no se activa sola. Complete el campo o configure el webhook a mano en el panel de Meta. | Complete Identificación de la cuenta comercial o configure el webhook manualmente en Meta con la dirección y el token de verificación mostrados. |
Probar conexión
El botón Probar conexión (tarjetas de la API oficial con número configurado) repite la verificación en cualquier momento: comprueba las credenciales, actualiza el teléfono y el nombre de la cuenta, consulta en Meta el estado de las llamadas y si el número está en coexistencia, rehace la vinculación con la conexión QR del mismo número, si la hay, mide la salud de la cuenta en Meta (bloqueo, límite por verificación) y revisa la suscripción de la recepción, rehaciéndola cuando hace falta (ver Salud de la cuenta en Meta).
QR y API oficial en el mismo número
Cuando una conexión QR y una conexión de la API oficial tienen el mismo teléfono, ChatISP las vincula solo (con o sin el noveno dígito) y pasa a tratarlas como un único canal de atención. Es el escenario de coexistencia: el número está en la aplicación WhatsApp Business, conectado a ChatISP por el QR y también por la API oficial.
Cómo se comporta el par
- Una conversación por cliente. El mensaje del cliente llega por los dos canales, pero entra una sola vez en el panel. Los acuses de entrega y de lectura, las citas y las reacciones se asocian con el mensaje correcto, lleguen por el canal que lleguen.
- Un canal en todas las pantallas. En filtros, selectores, ficha del agente y demás listas, el número aparece una sola vez. Solo la pantalla de Conexiones muestra las dos tarjetas, dentro del bloque Conexiones vinculadas, porque es allí donde se gestiona cada transporte.
- El par sobrevive a la caída del QR. Si el teléfono se desconecta, la API oficial sigue atendiendo las conversaciones del número. Solo un número diferente leyendo el QR deshace el vínculo.
- Un solo cupo en el plan. El par cuenta como un número en el límite del plan.
- Recursos de la aplicación preservados. Las conversaciones nuevas quedan vinculadas a la vía QR, que trae foto y nombre del contacto y los recursos de editar, eliminar para todos y reaccionar.
Por dónde sale cada mensaje
La elección del canal sigue la política de la pestaña Canales y franquicia en Configuración. Con la configuración de fábrica (Usar las dos conexiones con Priorizar el QR y menús Mientras haya franquicia gratis):
| Situación | Canal usado |
|---|---|
| Mensajes del día a día (agente, IA, avisos) | QR, sin costo. La API oficial queda de reserva si el QR falla. |
| Menús interactivos de los flujos y tarjeta de la factura, con la ventana de 24 horas abierta | API oficial, mientras haya franquicia gratuita en el mes. Agotada, el menú sale como texto numerado por el QR y la factura sale en texto. |
| QR fuera de servicio | API oficial al frente, porque entregar vale más que ahorrar. |
| Fuera de la ventana de 24 horas | QR, ya que la API oficial solo aceptaría una plantilla paga. |
| Plantilla aprobada enviada desde el panel, los recordatorios de cobro o una campaña | API oficial (las plantillas solo existen en ella). |
Los modos Solo la API oficial y Solo el QR son estrictos: el sistema usa únicamente el canal elegido, sin recurrir al otro. Todas las opciones se explican en Configuración, pestaña Canales y franquicia.
En un número vinculado, el cuadro de mensaje nunca queda bloqueado esperando una plantilla, aunque la ventana de 24 horas esté cerrada: el texto libre tiene por dónde salir por el QR. Si el QR está fuera de servicio y la ventana cerrada, el panel muestra el aviso El canal QR de este número está desconectado y la ventana de 24 horas de la API oficial se cerró. Reconecta el QR en Conexiones para que el texto libre llegue, o envía una plantilla aprobada., pero deja el cuadro libre.
Ventana de 24 horas y plantillas aprobadas
En la API oficial rige la regla de Meta: la empresa puede enviar mensajes libres (texto, multimedia, menú) solo dentro de las 24 horas contadas desde el último mensaje del cliente. Cada nuevo mensaje del cliente reabre la ventana por otras 24 horas. Fuera de ella, solo llegan al cliente las plantillas de mensaje aprobadas por Meta.
Qué ve el agente
En una conversación de un número que tiene solo la API oficial, con la ventana cerrada, el cuadro de mensaje queda bloqueado con el texto Fuera de la ventana de 24 h: envíe una plantilla y la barra La ventana de 24 horas de la API oficial se cerró: hasta que el cliente responda, solo una plantilla aprobada le llega. El botón Enviar plantilla abre la lista de plantillas aprobadas, con los campos de las variables. Las notas internas siguen libres. Si Meta rechaza un mensaje por ventana cerrada, el panel avisa Fuera de la ventana de 24 horas de la API oficial. Envíe una plantilla aprobada.
En un número con QR (solo o vinculado a la API), nada de esto bloquea: el texto libre sale por el QR.
Plantillas de la cuenta
Las plantillas se crean y aprueban en el Administrador de WhatsApp de Meta; ChatISP mantiene una copia de las plantillas de la cuenta para usarlas en el panel, en los recordatorios de cobro y en las campañas. En la tarjeta de la API oficial (con la identificación de la cuenta comercial completa), el botón Plantillas abre la lista:
- Cada plantilla muestra nombre, idioma, situación en Meta (por ejemplo
APPROVEDpara aprobada), categoría y el texto con las variables{{1}},{{2}}... - Sincronizar con Meta busca la lista actualizada (el mensaje confirma cuántas plantillas se sincronizaron). Las plantillas eliminadas en Meta desaparecen de la lista.
- Gestionar en Meta abre el administrador de plantillas de su cuenta comercial, donde se crea una plantilla y se envía a aprobación.
Plantillas de inicio de conversación
No toda plantilla tiene el mismo uso: algunas están hechas para envíos masivos, otras para traer al cliente a una conversación. En la página Plantillas Meta, cada tarjeta tiene el interruptor Inicio de conversación, que se guarda al hacer clic. Activado, la plantilla aparece al iniciar una conversación desde el panel y en el botón Enviar plantilla cuando la ventana de 24 horas se cierra. Desactivado, queda para las campañas y la regla de cobranza y para las promociones. Mientras ninguna plantilla de la conexión esté activada, todas aparecen en todos lados. El filtro Inicio de conversación muestra solo las marcadas, y la marca acompaña la copia al duplicar una plantilla.
Cuando la lista local está vacía, el panel busca las plantillas en Meta solo la primera vez que alguien intenta enviar una. Para el envío desde el panel sirven las plantillas aprobadas sin encabezado multimedia (imagen, video o documento en el encabezado), porque el panel completa solo las variables del texto.
Meta siempre cobra las plantillas, incluso dentro de la franquicia mensual. Úselas para iniciar o retomar una conversación fuera de la ventana, y deje el resto de la atención para el texto libre.
Franquicia y costos de la API oficial
Meta cobra por cada mensaje enviado por la API oficial, incluso dentro de la ventana de 24 horas, y libera 1.000 mensajes de servicio gratuitos por mes en cada número. Las plantillas siempre se pagan. Los mensajes enviados por el QR no tienen costo. ChatISP acompaña ese consumo y deja que el administrador decida cómo usar la franquicia.
Gestor de consumo en la tarjeta
Cada tarjeta de la API oficial con número configurado muestra el cuadro Franquicia de Meta:
- La barra y la leyenda {usado} de {limite} mensajes gratis usados en el mes, con el total en números (por ejemplo,
640 / 1.000). A partir del 80% del límite, el cuadro cambia de color como alerta. - Cuando se supera la franquicia, la barra muestra un tramo pago y aparece N mensajes más allá de la franquicia · estimación a pagar a Meta: R$ X. La estimación usa el precio por mensaje configurado y la cotización del dólar más reciente conocida por el sistema (sin cotización, aparece en dólares).
- Plantillas enviadas (siempre pagadas): N muestra cuántas plantillas salieron en el mes.
- El enlace Configurar lleva directo a la pestaña Canales y franquicia en Configuración.
El contador se reinicia el día 1 de cada mes según el reloj del servidor, una aproximación del ciclo de facturación de Meta. La estimación es solo una referencia: la tarifa real varía por país y por categoría, y la factura oficial es la de Meta.
Política de uso (resumen)
En la pestaña Canales y franquicia de Configuración, el administrador elige en tarjetas seleccionables, que se guardan con el clic:
| Bloque | Opciones |
|---|---|
| Cómo trabajar en un número con QR y API oficial | Usar las dos conexiones (recomendado), Solo la API oficial o Solo el QR. |
| Prioridad de los mensajes (solo en Usar las dos) | Priorizar el QR (recomendado, máximo ahorro) o Priorizar la API oficial (consume la franquicia). |
| Menús de los flujos por la API oficial (solo al priorizar el QR) | Mientras haya franquicia gratis, Siempre, incluso pagando o Nunca, solo texto numerado. |
| Segunda vía con botones de copiar por la conexión QR Code | Factura con botones de copiar o en texto por la conexión QR Code (nace desactivado). |
| Segunda vía con botones de copiar por la API oficial | Factura con botones o en texto, clave Pix y nombre del beneficiario. |
| Franquicia y estimación de gasto | Franquicia mensual por número (1.000 de fábrica; redúzcala para guardar margen) y Precio por mensaje excedente (US$), usado solo en la estimación. |
Una franja En la práctica resume en una frase el efecto de la combinación elegida. La explicación completa de cada opción está en Configuración.
Las políticas de canal afectan a los números vinculados (QR y API en el mismo número). En un número que tiene solo la API oficial, todos los mensajes salen por ella y consumen la franquicia.
Recursos de la tarjeta de la conexión
Además del estado y de las acciones principales, la tarjeta concentra ajustes que valen número por número.
Cliente escribiendo en vivo (QR)
Disponible en las tarjetas QR, con la etiqueta Activado o Desactivado y el botón para alternar. El cambio rige al instante, sin reconectar (Listo, el cambio ya vale para este número.). Viene activado.
| Estado | Efecto |
|---|---|
| Activado | El panel muestra "escribiendo..." y "grabando audio..." en tiempo real y la IA espera a que el cliente termine antes de responder. Mientras está activado, el teléfono vinculado a este número no suena con las notificaciones de mensaje, como sucede con WhatsApp Web abierto. |
| Desactivado | El teléfono vinculado vuelve a sonar con las notificaciones de mensaje. El panel deja de mostrar el "escribiendo..." y la IA responde sin esperar a que el cliente termine de escribir. |
Con las llamadas de voz activas en el número, el teléfono sigue sin sonar con los mensajes aunque el recurso esté desactivado, porque la línea de llamadas debe quedar disponible para recibir llamadas.
Llamadas de voz Recurso del plan
Cuando el servicio de llamadas está disponible en la instalación y en el plan, cada tarjeta incluye el cuadro Llamadas de voz, con el estado y el botón Activar llamadas o Desactivar llamadas:
- En la vía QR, las llamadas usan un segundo dispositivo vinculado del mismo número: al activarlas, se lee otro código QR en el mismo teléfono. El código leído en el teléfono de otro número se rechaza y se deshace al instante. La conexión de mensajes debe estar conectada antes.
- En la API oficial, no hay dispositivo: el recurso se activa en el propio número, en Meta, y solo existe en un número dedicado (sin coexistencia).
Desactivar las llamadas no afecta los mensajes. El paso a paso completo está en Llamadas de voz y video.
Base de conocimiento
Toda tarjeta tiene el cuadro Base de conocimiento con la etiqueta de la base que la asistente usa en este número y el botón Cambiar, que abre Base de conocimiento de este número: tocar una base graba al instante y vale también para el canal gemelo del mismo número. Sin base, la etiqueta queda en alerta (Ninguna) y el botón pasa a ser Elegir base; en ese estado la asistente atiende sin planes, condiciones y respuestas registradas. Con una sola base en la instalación, la conexión nueva ya nace atendida por ella. Vea Varias bases: una por empresa.
Botones de la tarjeta
| Botón | Dónde aparece | Qué hace |
|---|---|---|
| Conectar | QR desconectado | Abre la lectura del código QR. |
| Desconectar | QR conectado o esperando lectura | Desvincula el dispositivo de WhatsApp. Pide confirmación (¿Desconectar este WhatsApp?). |
| Configurar API | API oficial | Abre los campos de credenciales y la dirección del webhook. |
| Probar conexión | API oficial con número configurado | Revalida credenciales, teléfono, nombre de la cuenta y estado de las llamadas. |
| Plantillas | API oficial con cuenta comercial informada | Lista, sincroniza y lleva al administrador de plantillas de Meta. |
| Datos de la API | API oficial con número configurado | Muestra los datos de la cuenta en Meta con botones de copiar y la desvinculación de Ravi Systems. Vea Llevar el número a otro sistema. |
| Editar | Todas | Cambia el nombre de la conexión. El nombre es lo que el equipo ve en los filtros y en las conversaciones. |
| Cambiar / Elegir base | Todas | Elige la base de conocimiento que la asistente usa en este número. |
| Eliminar | Todas | Quita la conexión preservando el historial. Vea la sección siguiente. |
Salud de la cuenta en Meta
Además del estado, la tarjeta de cada conexión de la API oficial muestra lo que la propia Meta dice sobre la cuenta. El panel consulta a Meta cada hora (cada 5 minutos cuando hay problema) y siempre que hace clic en Probar conexión.
| Qué aparece | Significado | Qué hacer |
|---|---|---|
| Envío bloqueado por Meta | La cuenta de WhatsApp Business no puede iniciar ninguna conversación: plantillas, campañas y recordatorios de cobro no salen, aunque la API acepte el mensaje. El motivo más común es una forma de pago inválida o ausente. | Use el botón Forma de pago, que abre la pantalla de Meta ya en la cuenta correcta (solo un administrador del portafolio dueño de la cuenta puede cambiar la forma de pago). Para otros motivos el botón abre el Administrador de WhatsApp. Luego, Probar conexión. |
| Nota Meta aún no verificó la empresa en el portafolio ... | La cuenta envía normalmente, pero Meta limita las conversaciones iniciadas por la empresa por día mientras el portafolio dueño de la cuenta no pase la verificación de negocios. El nombre del portafolio aparece en la nota porque la verificación es por portafolio, no por cuenta. | Enlace Verificar empresa, que abre el Centro de seguridad de ese portafolio. El límite actual del número aparece en el Administrador de WhatsApp. |
| Recepción no activada en Meta | La cuenta no está suscrita con la dirección de esta instalación: Meta no entrega mensajes recibidos ni confirmaciones de envío. El panel lo corrige solo; este aviso solo aparece cuando Meta rechazó la corrección, con su respuesta. | Probar conexión repite la suscripción. Si persiste, revise la dirección pública de la instalación en Configuración. |
| Nota N mensajes ... sin confirmación de entrega hace más de 24 horas | Meta confirma cada envío en segundos. Mensajes de la API detenidos en Enviado por más de un día indican recepción muda o cuenta bloqueada. | Probar conexión y revisar los dos avisos anteriores. |
El botón Forma de pago está siempre en el pie de la tarjeta de la API oficial, incluso sin aviso, para registrar o cambiar la tarjeta en Meta en cualquier momento.
Estados de la conexión
La etiqueta en la parte superior de la tarjeta muestra el estado actual. En las conexiones QR, el estado se verifica con el servicio de WhatsApp en cada actualización de la pantalla, así que refleja lo que realmente está sucediendo.
| Etiqueta | Tipo | Qué significa | Qué hacer |
|---|---|---|---|
| Conectada | QR y API | El número está recibiendo y enviando por ChatISP. | Nada. |
| Conectando | QR | Hay un código QR generado esperando lectura. | Leer el código o cerrar la ventana e intentarlo después. |
| Desconectada | QR | El dispositivo no está conectado: fue desconectado en el panel, eliminado en Dispositivos vinculados en el teléfono, o la sesión se cayó. | Hacer clic en Conectar y leer el QR de nuevo. |
| Configuración pendiente | API | La conexión de la API oficial todavía no fue confirmada: credenciales no informadas, credenciales rechazadas en la última prueba o falla al activar la recepción al final del asistente. | Abrir Configurar API o Probar conexión. |
El cuadro de llamadas tiene estados propios (Llamadas desactivadas, Esperando la lectura, Llamadas activas, Llamadas fuera de servicio, Llamadas no disponibles), independientes del estado de los mensajes.
Si el servicio interno de WhatsApp del servidor está momentáneamente no disponible, la pantalla mantiene el último estado conocido en lugar de marcar todo como desconectado. Cuando el servicio vuelve, las sesiones conectadas se restauran solas, sin leer el QR de nuevo.
Conexiones por agente
En proveedores con más de un número (por ejemplo, uno para soporte y otro para ventas, o uno por ciudad), el gestor puede definir en qué números trabaja cada agente.
- Abra la pantalla Agentes y edite el agente.
- En el campo Conexiones, marque los números en los que actúa. La sugerencia de la pantalla resume la regla: El agente solo ve y recibe las conversaciones y llamadas de las conexiones marcadas. Ninguna marcada: actúa en todas.
- Guarde. La columna Conexiones de la lista de agentes muestra la elección (Todas cuando no hay ninguna marcada).
Qué alcanza la restricción
- Lista de conversaciones, apertura de conversación e inicio de una conversación nueva desde el panel: solo en los números marcados.
- Distribución automática (ruleta) y avisos de cola y de transferencia: el agente solo es elegido o avisado para conversaciones de sus números.
- Llamadas de voz: solo las de sus números.
- Automatización de envíos: los recordatorios de cobro y las campañas solo pueden crearse en los números del agente.
- Transferir o compartir una conversación con alguien que no actúa en ese número se rechaza con Este agente no actúa en la conexión de esta conversación.; la lista de destinos ya muestra solo a quienes pueden recibirla.
La restricción vale para cualquier perfil de acceso, incluso para quien tiene permiso para ver todas las conversaciones: quien marcó las casillas decidió dónde actúa el agente. Los números vinculados (QR y API) aparecen como una sola entrada, y marcar el número cubre los dos transportes. Las conversaciones antiguas sin conexión (de un número eliminado) no se restringen. Los contactos y los informes siguen solo los permisos del perfil.
Más sobre la ficha del agente en Usuarios y perfiles.
Desconectar, eliminar y reconectar el mismo número
El historial de atención pertenece al número, no a la conexión. Cambiar el teléfono, cambiar el QR por la API oficial o recrear la conexión no borra nada.
Desconectar (QR)
Desconectar quita ChatISP de los dispositivos vinculados de WhatsApp y borra la sesión guardada, para que no vuelva sola. Si las llamadas de voz estaban activas en el número, el dispositivo de llamadas también sale. La tarjeta sigue en la pantalla con el teléfono registrado, lista para Conectar de nuevo. En un número vinculado, la API oficial sigue atendiendo mientras el QR está fuera.
Eliminar
Eliminar pide la confirmación ¿Eliminar esta conexión? Las conversaciones registradas se mantendrán y se vincularán automáticamente cuando el mismo número vuelva a conectarse, por código QR o API oficial. Al confirmar:
- Si es un QR conectado, el dispositivo se desvincula de WhatsApp antes; si las llamadas estaban activas, el dispositivo de llamadas también.
- Protocolos, mensajes, eventos, notas internas, responsables, contactos y llamadas antiguas se preservan.
- Las campañas que estaban enviando por esa conexión quedan en pausa.
- La base de conocimiento no se borra: sigue en la pantalla Base de conocimiento, en espera. ChatISP guarda, por número, qué base y qué flujos atendían esa conexión.
- Si la conexión gemela (el otro transporte del mismo número) sigue conectada, asume las conversaciones de inmediato.
- Sin ningún transporte del número, las conversaciones siguen disponibles para consulta y notas internas, pero el cuadro de mensaje queda bloqueado con Esperando conectar el mismo número.
Reconectar el mismo número
Cuando el mismo número vuelve a conectarse, por QR o por la API oficial, la base de conocimiento y los flujos que atendían el número vuelven solos (siempre que la base siga activa y la conexión nueva todavía no tenga una base elegida), y ChatISP vuelve a vincular automáticamente todas las conversaciones de ese número, abiertas y finalizadas, y el cuadro de mensaje se libera solo en las conversaciones abiertas, sin recargar la página. Esto sucede incluso si el primer mensaje llega antes de que alguien abra la pantalla de Conexiones.
Un número diferente nunca hereda el historial de otro, aunque usted reutilice la conexión. Si el QR de una conexión es leído por otro teléfono, las conversaciones del número anterior se desprenden de ella y esperan el regreso del número original.
Llevar el número a otro sistema
La cuenta conectada por la API oficial pertenece a su empresa, no a Ravi Systems. El número, la cuenta de WhatsApp Business y las plantillas de mensaje están en su portafolio empresarial de Meta y pueden usarse en cualquier sistema homologado por Meta. ChatISP no pone ninguna barrera a la salida: queremos clientes por la calidad del servicio, nunca por una prisión técnica.
Datos de la API
En la tarjeta de una conexión por la API oficial, el botón discreto Datos de la API abre la ventana con todo lo que el nuevo proveedor puede pedir, cada dato con el botón Copiar:
- Número de WhatsApp y Nombre verificado;
- Identificación del número;
- Cuenta de WhatsApp Business e Identificación de la cuenta comercial;
- Portafolio empresarial e Identificación del portafolio.
La ventana se abre al instante con lo que el panel ya sabe y luego consulta los datos a Meta (Consultando a Meta...). El token de acceso no aparece a propósito: está ligado a esta instalación y no funciona en otro sistema. El nuevo proveedor genera el suyo al conectar la misma cuenta.
Paso a paso de la migración
- Si quiere conservar el historial de conversaciones, haga el respaldo de ChatISP en Configuración. El historial queda con usted; ningún sistema lo importa por Meta.
- En el nuevo sistema, conecte el número por el registro de Meta (el mismo inicio de sesión en Facebook usado aquí). Entre con la cuenta que administra su portafolio y elija la misma cuenta de WhatsApp Business y el mismo número. Las plantillas aprobadas acompañan la cuenta.
- Vuelva a ChatISP, abra Datos de la API y haga clic en Desvincular de Ravi Systems. ChatISP cancela la recepción de mensajes en Meta, borra la credencial guardada y elimina la conexión. El historial de atención se conserva, como en Eliminar.
- Si prefiere hacerlo en Meta, en Configuración del negocio, Integraciones, Apps conectadas, quite la app de ChatISP. Después use Desvincular de Ravi Systems o Eliminar en el panel.
Mientras la conexión no se desvincule, los dos sistemas reciben los mensajes del número: Meta entrega a cada app inscrita en la cuenta. Desvincule en cuanto el nuevo sistema esté atendiendo, para que el equipo no responda en dos lugares.
Desvincular de Ravi Systems solo concluye cuando Meta confirma la cancelación. Si Meta lo rechaza, el panel muestra el motivo y no se cambia nada. La excepción es la credencial ya inválida (app ya quitada en Meta): ahí no hay nada que cancelar y la conexión se elimina.
Buenas prácticas
- Use nombres claros. Use Editar para nombrar cada conexión según su función (por ejemplo, "Soporte" y "Ventas"). Ese es el nombre que el equipo ve en los filtros, en las conversaciones y en la automatización de envíos.
- Mantenga el teléfono del QR encendido y con internet. WhatsApp puede desconectar dispositivos vinculados cuando el teléfono principal pasa mucho tiempo sin uso, así que use WhatsApp en el teléfono de vez en cuando.
- Mantenga la aplicación de WhatsApp actualizada en el teléfono del número, principalmente en la coexistencia, que exige WhatsApp Business actualizado.
- Prefiera la combinación de QR y API oficial en el mismo número cuando quiera menús con botones y la tarjeta de cobro sin gastar la franquicia en la atención común.
- Acompañe el gestor de consumo en la tarjeta de la API oficial y, si quiere margen, reduzca la franquicia mensual en Configuración para que el sistema ahorre la API antes del límite real.
- Cree las plantillas con anticipación en el Administrador de WhatsApp de Meta, porque la aprobación no es inmediata, y sincronícelas en Plantillas.
- Prepare la dirección pública antes de la API oficial en la instalación propia: dominio y certificado configurados en Servidor.
- Elimine sin miedo cuando necesite cambiar el transporte. El historial queda guardado y vuelve solo cuando el mismo número se conecte.
Problemas comunes
| Síntoma | Causa probable y solución |
|---|---|
| El código QR no aparece y surge El servidor no pudo comunicarse con WhatsApp... | El servidor no tiene salida a internet hasta WhatsApp. Verifique el firewall, las rutas y el DNS del servidor y use Generar nuevo código. |
| El código expira antes de que dé tiempo a leerlo | Deje el teléfono con el lector de Dispositivos vinculados abierto antes de solicitar el código y use Generar nuevo código. |
| La tarjeta QR aparece Desconectada sin que nadie la haya desconectado | El dispositivo fue eliminado en el teléfono o la sesión se cayó. Haga clic en Conectar y lea el QR. Si el teléfono muestra el dispositivo como conectado pero el panel no, elimine el dispositivo en el teléfono y conéctelo de nuevo; si persiste, contacte al soporte de Ravi Systems. |
| La API oficial envía, pero no recibe mensajes | La recepción no fue suscrita o Meta no alcanza la dirección del webhook. Revise el aviso de Configurar API, la identificación de la cuenta comercial y si el servidor tiene un dominio con HTTPS accesible desde internet. |
| El cuadro de mensaje muestra Fuera de la ventana de 24 h: envíe una plantilla | Número solo con API oficial y cliente sin escribir hace más de 24 horas. Envíe una plantilla aprobada o conecte el QR del mismo número. |
| Enviar plantilla dice que no hay plantillas | La cuenta todavía no tiene una plantilla aprobada o la lista no se sincronizó. Cree la plantilla en Meta (Gestionar en Meta) y use Sincronizar con Meta en el botón Plantillas de la tarjeta. |
| Los menús de los flujos llegan como texto numerado en un número vinculado | Comportamiento esperado cuando la franquicia del mes se agotó, cuando la ventana de 24 horas está cerrada o cuando la política de menús es Nunca, solo texto numerado. |
| Editar, eliminar o reaccionar desaparecieron de una conversación de número vinculado | Esos recursos dependen de la vía QR. Verifique si el QR del número está Conectada. |
| El botón Nueva conexión no aparece | Se alcanzó el tope de números del plan (vea el medidor en la parte superior de la pantalla) o el usuario no tiene el permiso Conexiones de WhatsApp. |
| Conversaciones antiguas con el cuadro bloqueado en Esperando conectar el mismo número. | La conexión de ese número fue eliminada. Conecte el mismo número de nuevo, por QR o API oficial, y las conversaciones vuelven a funcionar. |
| Un agente no ve las conversaciones de un número | Está restringido a otras conexiones en la ficha de Agentes. Marque el número o deje todas desmarcadas. |