Glosario
Glosario de WhatsApp API y automatización: 40 términos explicados
Estos son los términos que aparecen cuando integras o automatizas WhatsApp, cada uno con una definición corta y correcta: instancia, webhook, plantilla, ventana de 24 horas, BSP, código QR, calentamiento y otros. Usa el índice, ve directo al término y sigue los enlaces a la guía completa.
Equipo ZapZap API · Publicado el
Conceptos básicos
Instancia
- Número de WhatsApp conectado a una API, con sesión, ID, credenciales y webhook propios. Cada número activo es una instancia, y cada una tiene su propia sesión.Qué es una instancia de WhatsApp
Código QR
- Código que lees con el celular para vincular un número a la instancia, igual que el inicio de sesión en WhatsApp Web. Si la conexión se cae, puede que debas leerlo de nuevo.Inicio rápido
Sesión
- Conexión activa entre el número y el servidor después de la vinculación. Mientras la sesión esté abierta, la instancia envía y recibe mensajes; cuando se cae, el estado pasa a desconectado.
API no oficial
- Servicio que expone por API una sesión de WhatsApp Web, sin pasar por la plataforma de Meta. Es más flexible y rápida de empezar, pero no es un canal homologado y el número puede ser restringido.Guía honesta de la API no oficial
Número virtual
- Número de teléfono sin SIM física dedicada, normalmente ofrecido por un servicio de telefonía. Puede recibir el código de verificación de WhatsApp, pero conviene entender cómo se obtuvo el número antes de usarlo.Número virtual para WhatsApp
Grupo
- Conversación con varios participantes. Por la API se pueden leer eventos del grupo y enviarle mensajes.Módulos de grupos
Autoalojado (self-hosted)
- Modelo en el que instalas y operas el software en tu propio servidor, como WAHA o Evolution API. Controlas el entorno y asumes actualizaciones, respaldo y disponibilidad.ZapZap vs WAHA
Estado de entrega
- Estado de un mensaje enviado: enviado, entregado o leído. La API informa estos cambios por eventos, lo que permite seguir lo que llegó al destinatario.
API oficial de Meta
API oficial (WhatsApp Business Platform)
- Plataforma de Meta para empresas. Exige verificación del negocio, usa plantillas aprobadas para iniciar conversaciones y, según la documentación de Meta, se cobra por mensaje de plantilla entregado desde el 1 de julio de 2025.WhatsApp Business API
Cloud API
- Versión de la API oficial alojada por la propia Meta y accesible por HTTP. Se puede usar directamente o a través de un socio (BSP).
BSP (proveedor de soluciones)
- Business Solution Provider: empresa socia de Meta que da acceso y soporte a la API oficial, normalmente cobrando una tarifa propia además del precio de Meta.ZapZap vs 360dialog
Plantilla (template)
- Mensaje preaprobado por Meta, obligatorio para que la empresa inicie una conversación o escriba fuera de la ventana de 24 horas en la API oficial. Puede tener variables, como nombre y fecha.
Categorías de plantilla
- Clasificación de Meta para las plantillas: marketing, utilidad y autenticación. La categoría influye en la regla de uso y en el precio por mensaje en la API oficial.
Ventana de 24 horas
- Plazo que empieza cuando el cliente envía un mensaje. Dentro de él, la empresa puede responder con texto libre en la API oficial; fuera, solo se puede enviar una plantilla aprobada.
Verificación del negocio
- Proceso de Meta para confirmar la identidad de la empresa, exigido para usar la API oficial a escala. Toma tiempo y pide documentos, lo que la vía no oficial no exige.
Mensaje interactivo (botones y listas)
- Mensaje con botones de respuesta o lista de opciones. Facilita la elección del cliente y ordena la atención, y la disponibilidad varía según el tipo de API.Botones y listas en WhatsApp
Riesgo y buenas prácticas de envío
Calentamiento
- Uso gradual y natural de un número nuevo antes de ponerlo en volumen, para que su historial parezca el de una persona. Reduce el riesgo de restricción, pero no lo elimina.Calentamiento de chip
Bloqueo (baneo)
- Restricción que WhatsApp aplica a un número, temporal o definitiva. Los Términos de WhatsApp prohíben los mensajes masivos y automáticos, y ningún proveedor puede garantizar que no ocurra.Antibloqueo
Opt-in
- Consentimiento previo de la persona para recibir mensajes de la empresa. Registrar cuándo y cómo se dio es una buena práctica y te protege.
Opt-out
- La salida: la forma de que la persona pida no recibir más mensajes. Facilitarla y respetar el pedido reduce denuncias y problemas legales.
LGPD
- Ley General de Protección de Datos de Brasil (Ley 13.709/2018), que regula el tratamiento de datos personales. El consentimiento es una de las bases legales, y la ley prevé otras.Envío masivo y LGPD
Envío masivo
- Envío del mismo mensaje, o de variaciones suyas, a muchos contactos. Es la práctica de mayor riesgo para el número y la que más exige consentimiento, texto variado y ritmo controlado.Envío masivo
Lista de difusión
- Función de la app de WhatsApp para enviar un mensaje a varios contactos, que lo reciben como conversación individual. Solo llega a quien guardó tu número en sus contactos.
Seguimiento (follow-up)
- Mensaje de seguimiento después de un primer contacto, para retomar la conversación. Funciona mejor con un intervalo respetuoso, valor real y una salida fácil.Cómo hacer seguimiento
Integración y desarrollo
Webhook
- URL de tu sistema que recibe un aviso (una solicitud HTTP) cada vez que algo ocurre, como un mensaje recibido. Evita consultar la API cada cierto tiempo.Webhooks
Evento
- Aviso que envía la API cuando algo cambia: mensaje recibido, cambio del estado de entrega, instancia conectada o desconectada. Llega a tu webhook.
Endpoint
- Dirección de una operación de la API, como la de enviar texto. Cada endpoint tiene método HTTP, parámetros y respuesta definidos.Referencia de la API
API REST
- Estilo de API en el que haces solicitudes HTTP (GET, POST y otras) a direcciones y recibes respuestas en JSON. Es el formato que usa la mayoría de las APIs de WhatsApp.
Payload
- Cuerpo de datos de una solicitud o de un evento, normalmente en JSON. En el envío de un mensaje, lleva el número y el texto.Enviar mensaje
Clave y secreto de API
- Par de credenciales que identifica tu cuenta en cada solicitud. El secreto debe quedarse solo en tu servidor, nunca en código de navegador ni de aplicación.Autenticación
Formato E.164 (código de país)
- Estándar internacional de número: código de país seguido del código de área y del número, solo dígitos y con un máximo de 15 en total. En Brasil, 55 + código de área + número, como 5511999999999.
Límite de solicitudes (rate limit)
- Tope de llamadas a la API en un intervalo. Al superarlo, el servidor suele responder con el código 429, y lo correcto es esperar y reintentar más despacio.
Idempotencia
- Propiedad de repetir la misma operación sin efecto duplicado. Importa para no enviar dos veces el mismo mensaje cuando una solicitud se repite por una falla de red.
Código de estado HTTP
- Número de la respuesta que indica el resultado de la llamada: 2xx es éxito, 4xx es un error de quien llama (como 401, sin autorización) y 5xx es un error del servidor.
Automatización y ventas
Chatbot
- Programa que responde mensajes de forma automática, por reglas o por IA. Funciona mejor cuando sabe pasar la conversación a una persona en el momento justo.Chatbot de WhatsApp con IA
Agente de IA
- Chatbot que usa inteligencia artificial para entender el contexto y responder en lenguaje natural, siguiendo instrucciones que defines, como el tono de voz y los límites.Respuesta automática con IA
Flujo (flow)
- Secuencia de pasos de una automatización: disparador, condiciones y acciones, como esperar, preguntar y enviar multimedia. En herramientas visuales se arma arrastrando bloques.Flow Builder
Embudo de ventas
- Etapas por las que pasa un contacto hasta comprar, como nuevo, en conversación, propuesta y cerrado. En WhatsApp, cada conversación se ordena en la etapa en que está.Embudo de ventas en WhatsApp
CRM
- Sistema que guarda contactos, historial y oportunidades de venta. Integrado con WhatsApp, registra las conversaciones y dispara mensajes a partir de las etapas del embudo.Integraciones con CRM
Automatización no-code
- Herramienta que conecta sistemas sin programar, como n8n, Make y Zapier. Recibe el evento de WhatsApp por webhook y dispara acciones en hojas de cálculo, CRMs y otras apps.Integración con n8n
Preguntas frecuentes
¿Qué es una instancia de WhatsApp?
Es un número de WhatsApp conectado a una API, con sesión, ID, credenciales y webhook propios. Cada número activo es una instancia.
¿Cuál es la diferencia entre la API oficial y la no oficial?
La oficial es la plataforma de Meta, con verificación del negocio, plantillas aprobadas y cobro por mensaje. La no oficial conecta tu número mediante una sesión de WhatsApp Web, acepta texto libre y no está homologada, por lo que el número puede ser restringido.
¿Para qué sirve un webhook?
Para que tu sistema reciba un aviso en el momento en que algo ocurre, como un mensaje recibido, sin consultar la API cada cierto tiempo.
¿Qué es la ventana de 24 horas?
Es el plazo, contado desde el mensaje del cliente, en que la empresa puede responder con texto libre en la API oficial. Fuera de él, solo una plantilla aprobada.
¿Listo para llevar los términos a la práctica?
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). Conecta una instancia por código QR y haz tu primer envío hoy.