¿Qué es una instancia de WhatsApp?
Una instancia de WhatsApp es un número de WhatsApp conectado a una API. Cada instancia tiene su propia sesión activa, su identificador (ID), sus credenciales y su configuración, y funciona separada de las demás. Si tienes tres números, tienes tres instancias. Es la unidad con la que creas, conectas, monitoreas y cobras cualquier operación por API.
Publicado el · 2 min de lectura
Este artículo también está disponible en: Português · English
Cómo funciona una instancia
Creas la instancia en el panel y se genera un ID. Luego vinculas el número leyendo un código QR con el celular, igual que se conecta WhatsApp Web. Desde ahí la instancia queda conectada en un servidor y puede enviar mensajes, recibir mensajes por webhook e informar su estado.
En ZapZap, el ID de la instancia forma parte de la dirección de cada llamada y la autenticación usa una clave y un secreto de la cuenta. El paso a paso está en el inicio rápido y en autenticación.
Qué hay dentro de una instancia
Cada instancia guarda el número conectado, el estado de la conexión (conectada o desconectada), la URL de webhook que recibe los eventos y su configuración propia, como la automatización asociada a ese número. Cada instancia tiene su propia sesión, así que una desconexión en un número no desconecta a los otros.
Lo que cambia entre proveedores es el modelo de cobro: en ZapZap cada número activo cuesta R$15 al mes, prepago, sin cobro por mensaje. Consulta precios para el valor vigente.
Cuántas instancias necesito
Una por cada número de WhatsApp que quieras operar. Una clínica con recepción y finanzas en números distintos usa dos. Una agencia que atiende diez clientes, cada uno con su número, usa diez.
Separar por función, como atención, ventas y cobranza, también ayuda: si un número tiene un problema, los demás siguen funcionando. Y conviene tener un número de reserva, porque ningún número es insustituible. Mira el glosario para los demás términos, o la guía de la API no oficial de WhatsApp para entender el contexto.
Resumen rápido
- Una instancia es un número de WhatsApp conectado a una API, con sesión, ID, credenciales y webhook propios.
- Creas la instancia en el panel y vinculas el número por código QR, como en WhatsApp Web.
- Una instancia por número. Separar por función aísla problemas y mantiene en marcha el resto de la operación.
Sigue leyendo
Lee también
Preguntas frecuentes
¿Una instancia es lo mismo que una cuenta de WhatsApp?
No exactamente. La cuenta es tu número en WhatsApp. La instancia es la conexión de ese número con la API: la sesión activa en el servidor, con ID, credenciales y webhook. Un número conectado a una API se vuelve una instancia.
¿Necesito el celular encendido para que la instancia funcione?
Usas el celular para leer el código QR y vincular el número. Después la sesión corre en el servidor. Si WhatsApp pide reconectar, habrá que leer el código QR de nuevo.
¿Qué pasa cuando una instancia se desconecta?
Los mensajes dejan de enviarse y recibirse por esa instancia hasta que el número se reconecte, normalmente leyendo el código QR otra vez. Las demás instancias no se ven afectadas.
¿Puedo tener más de una instancia en la misma cuenta?
Sí. Cada número activo es una instancia, y la misma cuenta puede tener varias, cada una con su ID y su webhook.
Crea tu primera instancia y conecta por código QR
Crea la cuenta, verifica el teléfono y recibe el crédito de bienvenida, sin depositar (uno por teléfono, sujeto a la campaña vigente). En pocos minutos tienes una instancia conectada.