Documentación de PolpoChat

PolpoChat convierte su número de WhatsApp en un centro de atención profesional. Es 100% web — solo necesita un navegador. Disponible en español, inglés y portugués.

Cómo empezar

1. Regístrese en app.polpochat.com con su correo electrónico
2. Su empresa se crea automáticamente al registrarse
3. Vaya a Configuración → Conexiones y conecte su WhatsApp escaneando el código QR
4. Invite a su equipo desde Configuración → Usuarios
5. Configure sus colas de atención (Ventas, Soporte, etc.)
6. ¡Listo! Los mensajes de WhatsApp llegarán como tickets a su bandeja

Tiene 14 días de prueba gratis sin tarjeta de crédito.

PolpoChat se conecta a WhatsApp mediante código QR (igual que WhatsApp Web). Puede conectar múltiples números según su plan.

Conectar un número

1. Vaya a Configuración → Conexiones y haga clic en "Agregar conexión"
2. Asigne un nombre a la conexión (ej: "WhatsApp Ventas")
3. Se mostrará un código QR — escanéelo con WhatsApp en su teléfono
4. La conexión pasará a estado Conectado automáticamente

Mensajes automáticos por conexión

Cada conexión puede tener mensajes configurables:

Multimedia soportada

Cada conversación de WhatsApp se convierte en un ticket con número secuencial, estado, agente asignado y cola. Los tickets se organizan en pestañas: Pendientes, Abiertos y Cerrados.

Estados del ticket

Estado	Descripción	Cuándo ocurre
Pendiente	Sin agente asignado	Cuando llega un mensaje nuevo
Abierto	En atención por un agente	Cuando un agente acepta el ticket
Cerrado	Conversación resuelta	Cuando el agente cierra el ticket

Herramientas dentro del ticket

Cada persona que le escribe se registra automáticamente como contacto con su nombre, número, foto de perfil e historial completo de conversaciones.

Campos del contacto

Campo	Descripción
Nombre	Nombre del contacto (se obtiene de WhatsApp automáticamente)
Número	Número de teléfono con código de país
Email	Correo electrónico (opcional)
Foto de perfil	Se sincroniza desde WhatsApp
Campos personalizados	Agregue cualquier campo adicional: empresa, cargo, dirección, etc.

Desde la sidebar del contacto puede ver todos sus tickets, notas y datos en un solo lugar.

Las colas son departamentos o áreas de atención (ej: Ventas, Soporte, Facturación). Cada cola tiene su propio color, horarios y configuración.

Configuración de cada cola

Los agentes se asignan a colas específicas — cada agente puede pertenecer a múltiples colas.

Organice sus tickets visualmente en un tablero de columnas. Cada columna corresponde a una etiqueta y puede arrastrar tickets entre ellas con drag & drop.

Cómo configurar

1. Cree etiquetas con nombre y color desde Etiquetas
2. Marque las etiquetas que desea como columnas del Kanban
3. Un administrador configura el orden de las columnas
4. Arrastre tickets entre columnas para cambiar su estado

Puede filtrar el Kanban por cola y usar el toggle "Ver todos" para ver tickets de todo el equipo.

Envíe mensajes a una lista de contactos de forma masiva. Disponible desde el plan Professional.

Cómo crear una campaña

1. Cree una lista de contactos (manual o importación)
2. Vaya a Campañas → Nueva campaña
3. Seleccione la lista de contactos y la conexión de WhatsApp
4. Redacte hasta 5 variaciones del mensaje (se selecciona una al azar por contacto para evitar spam)
5. Use variables como {nombre} y {email} para personalizar
6. Opcionalmente adjunte un archivo multimedia
7. Programe la fecha y hora de envío

Estados de la campaña

Estado	Descripción
Inactiva	Creada pero no programada
Programada	Lista para enviarse en la fecha configurada
En progreso	Enviando mensajes
Finalizada	Todos los mensajes enviados
Cancelada	Detenida manualmente

Los intervalos entre mensajes son configurables para controlar la velocidad de envío. Cada campaña genera un reporte detallado con el estado de cada envío.

Conecte PolpoChat con sus herramientas existentes. Disponible desde el plan Business.

Integraciones disponibles

Integración	Descripción	Configuración
Typebot	Chatbots visuales avanzados	Slug, keywords de finalización/reinicio, delay entre mensajes
N8N	Automatización de workflows	URL del webhook de N8N
API REST	Envíe/reciba mensajes desde su CRM, ERP o e-commerce	Bearer token por conexión WhatsApp
Webhooks	Reciba eventos en tiempo real en su servidor	URL de destino por conexión
BYOEcom	Conecte su ecommerce para vender por WhatsApp	URL base + API key del conector

API REST — Endpoints principales

Método	Endpoint	Descripción
POST	/api/messages/send	Enviar mensajes
GET	/api/tickets/:id	Obtener detalles de un ticket
PATCH	/api/tickets/:id	Actualizar un ticket
POST	/api/tags/sync-external	Sincronizar etiquetas

La documentación completa de la API con ejemplos curl está disponible dentro de la plataforma en API Externa.

BYOEcom (Bring Your Own Ecommerce) permite a las empresas conectar su tienda online con PolpoChat para vender directamente por WhatsApp. Disponible en planes Business y Enterprise.

Modos de operación

Configurar un conector

1. Vaya a Configuración → Ecommerce
2. Seleccione el tipo de conector (Shopify, WooCommerce, Custom, etc.)
3. Ingrese la URL base (HTTPS) y su API key
4. PolpoChat validará la conexión con un health check automático
5. Una vez conectado, los productos se sincronizan automáticamente

Funcionalidades principales

Modos de carrito

Modo	Quién agrega al carrito	Quién confirma
Self-service	El cliente (vía WhatsApp)	El cliente
Agent-assisted	El agente (desde dashboard)	El cliente (aprueba resumen)
Híbrido (default)	Ambos	El cliente

Sincronización de productos

Los productos se sincronizan automáticamente desde el ecommerce conectado:

Parámetro	Valor
Intervalo mínimo	15 minutos
Intervalo por defecto	60 minutos
Intervalo máximo	24 horas
Reintentos en fallo	5 intentos cada 5 minutos

Webhooks bidireccionales

PolpoChat recibe notificaciones de su ecommerce cuando cambia el estado de una orden. Automáticamente se envía un mensaje al cliente por WhatsApp con la actualización. Los conectores nativos (Shopify, WooCommerce, etc.) registran el webhook automáticamente durante la configuración.

API estándar para conectores custom

Si su ecommerce no está soportado nativamente, implemente estos endpoints siguiendo la especificación de API BYOEcom:

Método	Endpoint	Descripción
GET	/products	Listar productos con paginación
GET	/products/:id	Obtener un producto por ID
GET	/orders/:id	Obtener detalles de una orden
POST	/orders	Crear una nueva orden
GET	/health	Health check del conector

Varios agentes atienden desde el mismo número de WhatsApp simultáneamente. Cada uno ve su bandeja de tickets y puede colaborar con notas internas y chat entre agentes.

Roles del sistema

Rol	Acceso
Admin	Acceso completo: dashboard, campañas, conexiones, colas, usuarios, API, configuración
User (agente)	Mensajes, kanban, contactos, mensajes rápidos, programaciones, etiquetas
Super Admin	Todos los permisos de admin + gestión de empresas

Funciones de equipo

Precios por usuario al mes. 15% de descuento en pago anual.

Función	Starter $15	Professional $25	Business $40	Enterprise $60+
Usuarios	3	10	20	Ilimitados
Conexiones WhatsApp	1	3	5	Ilimitadas
Colas de atención	2	5	10	Ilimitadas
Tickets + CRM + Kanban	✓	✓	✓	✓
Mensajes rápidos	✓	✓	✓	✓
Multimedia completo	✓	✓	✓	✓
Campañas masivas	—	✓	✓	✓
Chat interno	—	✓	✓	✓
Dashboard métricas	—	✓	✓	✓
Integraciones	—	—	✓	✓
API REST + Webhooks	—	—	✓	✓
Ecommerce por WhatsApp (BYOEcom)	—	—	✓	✓
Soporte prioritario	—	—	—	✓

Todos los planes incluyen 14 días de prueba gratis. Sin contrato mínimo. Cancele cuando quiera.