Documentación de PolpoChat

Guía completa para configurar y aprovechar al máximo cada función de la plataforma.

Primeros pasos

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.

Conexión de WhatsApp

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:

👋

Bienvenida

Se envía al primer contacto del cliente.

🕐

Fuera de horario

Se envía cuando no hay agentes disponibles.

👋

Despedida

Se envía al cerrar un ticket.

Expiración

Se envía cuando un ticket expira por inactividad.

Multimedia soportada

🖼️

Imágenes

JPEG, PNG, WebP, GIF

🎵

Audio

MP3, M4A, OGG, WAV (conversión automática)

🎬

Video

MP4, MOV, WebM, 3GP

📄

Documentos

PDF, Word, Excel y cualquier archivo

📍

Ubicación

Coordenadas GPS compartidas

👤

Contactos

Tarjetas vCard

Sistema de tickets

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

EstadoDescripciónCuándo ocurre
PendienteSin agente asignadoCuando llega un mensaje nuevo
AbiertoEn atención por un agenteCuando un agente acepta el ticket
CerradoConversación resueltaCuando el agente cierra el ticket

Herramientas dentro del ticket

Mensajes rápidos

Escriba / + shortcode para insertar respuestas predefinidas. Pueden incluir archivos.

Notas internas

Comentarios privados visibles solo para su equipo, no para el cliente.

Mensajes programados

Programe envíos para una fecha y hora futura.

Reenvío

Reenvíe mensajes entre tickets con un clic.

Etiquetas

Clasifique tickets con etiquetas de color para organizar y filtrar.

Transferir

Transfiera el ticket a otra cola o agente.

Contactos (CRM)

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

CampoDescripción
NombreNombre del contacto (se obtiene de WhatsApp automáticamente)
NúmeroNúmero de teléfono con código de país
EmailCorreo electrónico (opcional)
Foto de perfilSe sincroniza desde WhatsApp
Campos personalizadosAgregue 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. También puede desactivar el chatbot de IA para contactos específicos.

Colas de atención

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

🎨

Nombre y color

Identifique visualmente cada departamento.

👋

Mensaje de bienvenida

Se envía automáticamente al cliente cuando entra a la cola.

🕐

Horarios

Configure días y horas de atención. Fuera de horario se envía un mensaje automático.

🤖

Chatbot IA

Asigne un prompt de OpenAI para respuestas automáticas.

🔗

Integración

Conecte Typebot o N8N a la cola.

📋

Menú interactivo

Opciones de autoservicio con sub-opciones anidadas.

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

Vista Kanban

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.

Campañas masivas

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

EstadoDescripción
InactivaCreada pero no programada
ProgramadaLista para enviarse en la fecha configurada
En progresoEnviando mensajes
FinalizadaTodos los mensajes enviados
CanceladaDetenida 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.

Chatbot con IA

Configure un chatbot con OpenAI (GPT) que atiende automáticamente, califica al cliente y escala al agente humano solo cuando se necesita. Disponible desde el plan Business.

Cómo configurar

  1. Vaya a Configuración → Prompts y cree un nuevo prompt
  2. Escriba las instrucciones del chatbot (qué debe responder, tono, límites)
  3. Ingrese su API Key de OpenAI
  4. Seleccione el modelo (GPT-3.5 Turbo o GPT-4o Mini)
  5. Configure límites: máximo de mensajes de contexto, tokens y temperatura
  6. Asigne el prompt a una cola de atención

Parámetros configurables

ParámetroDescripción
PromptInstrucciones del sistema — define el comportamiento del bot
Modelogpt-3.5-turbo-1106 o gpt-4o-mini
Max mensajesCantidad de mensajes de contexto que recibe el bot
Max tokensLímite de tokens por respuesta
TemperaturaCreatividad de las respuestas (0 = preciso, 1 = creativo)

Nota: Usted provee su propia API key de OpenAI. El costo típico es de $5–20/mes dependiendo del volumen.

Flow Builder

Diseñe flujos de conversación automatizados con un editor visual de drag & drop — sin escribir código. Disponible desde el plan Business.

Tipos de nodos

🟢

Inicio

Punto de entrada del flujo.

💬

Mensaje

Envía un mensaje de texto al contacto.

⏱️

Intervalo

Espera un tiempo antes de continuar.

📋

Menú

Presenta opciones interactivas al cliente.

Pregunta

Hace una pregunta y captura la respuesta.

🎲

Aleatorio

Selecciona un camino al azar (A/B testing).

🖼️

Imagen

Envía una imagen al contacto.

🎵

Audio

Envía un audio al contacto.

🎬

Video

Envía un video al contacto.

🎫

Ticket

Crea o transfiere un ticket.

🤖

OpenAI

Integra respuesta de IA en el flujo.

🔗

Typebot

Conecta con un flujo de Typebot.

Puede asignar flujos como bienvenida (primer mensaje) o como respuesta cuando no se reconoce la frase del cliente. También puede crear campañas de flujo activadas por palabras clave.

Integraciones

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

Integraciones disponibles

IntegraciónDescripciónConfiguración
TypebotChatbots visuales avanzadosSlug, keywords de finalización/reinicio, delay entre mensajes
N8NAutomatización de workflowsURL del webhook de N8N
API RESTEnvíe/reciba mensajes desde su CRM, ERP o e-commerceBearer token por conexión WhatsApp
WebhooksReciba eventos en tiempo real en su servidorURL de destino por conexión

API REST — Endpoints principales

MétodoEndpointDescripción
POST/api/messages/sendEnviar mensajes
GET/api/tickets/:idObtener detalles de un ticket
PATCH/api/tickets/:idActualizar un ticket
POST/api/tags/sync-externalSincronizar etiquetas

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

Equipo y roles

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

RolAcceso
AdminAcceso completo: dashboard, campañas, flow builder, conexiones, colas, usuarios, API, configuración
User (agente)Mensajes, kanban, contactos, mensajes rápidos, programaciones, etiquetas
Super AdminTodos los permisos de admin + gestión de empresas

Funciones de equipo

Chat interno

Comunicación entre agentes sin salir de la plataforma. Salas con múltiples participantes.

Notificaciones

Alertas en tiempo real con sonido para nuevos mensajes. Sin recargar la página.

Dashboard

Métricas de tickets por día, por agente, pendientes y resueltos.

Anuncios

Comunicaciones internas del admin al equipo con prioridad y tracking de lectura.

Planes y límites

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

FunciónStarter $15Professional $25Business $40Enterprise $60+
Usuarios31025Ilimitados
Conexiones WhatsApp135Ilimitadas
Colas de atención2510Ilimitadas
Tickets + CRM + Kanban
Mensajes rápidos
Multimedia completo
Campañas masivas
Chat interno
Dashboard métricas
IA con OpenAI
Flow Builder
Integraciones
API REST + Webhooks
Soporte prioritario

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

¿Listo para empezar?

Configure su número de WhatsApp en menos de 5 minutos y vea la diferencia desde el primer día.