Multichannel
Inicia sesión
Primer arranque. Crea tu cuenta de administrador.
BD no operativa.
BD no operativa. El esquema aún no está creado.


Saltar al contenido
Multichannel
Messaging Hub
Atender
Contenido
Plantillas
Automatizar
Configurar
Usuarios
comprobando…
túnel: ?

Chat

Documentación API
sin etiquetas
0 seleccionados
Selecciona un contacto
Fuera de ventana de 24h
0:00 Grabando…
Cuando abras una conversación verás aquí su persona y las respuestas rápidas.
Persona
Plantillas locales

Canales

Conexiones a WhatsApp, Telegram, Messenger e Instagram

Meta App no configurada. Para usar "Conectar con Meta", primero introduce el App ID y App Secret de tu app en Meta for Developers.

Plantillas

Plantillas aprobadas por Meta para cada número de WhatsApp

Crear/editar en Meta
Para abrir el panel de Meta directamente añade tu Business ID en la edición del canal (sección Canales → Editar). Sin él se abre la URL genérica.

Plantillas locales

Multicanal · texto plano o markdown · se adapta al formato nativo de cada canal al enviar

Biblioteca de archivos

Archivos reutilizables entre conversaciones. Pueden ser globales o limitados a ciertos canales.

Sin archivos. Pulsa Subir archivo.

Subir a la biblioteca

Últimos eventos

Mensajes entrantes y salientes recientes

Webhooks sin procesar (0)

Personas
Selecciona una persona o créala

Bots IA

Bots que atienden conversaciones, su conocimiento (instrucciones y manuales) y los modelos que usan.

Bots

Un bot responde a las conversaciones del canal al que se asigna (en Canales → editar). Desde el chat se pausa por conversación; al contestar un humano se pausa solo.

Nuevo bot

Recibe POST JSON { bot, channel, contact, message, history } y responde { "reply": "…", "pause"?: true|minutos, "tags"?: [] } o texto plano.
0 = no pausar
Añadir:
Con motor webhook, las instrucciones, el conocimiento y las herramientas viven en el servicio externo. Comunica se encarga de la ventana de 24 h, la pausa por conversación, el registro y las reglas.
Conocimientos que usa
Instrucciones y manuales de la biblioteca (pestaña Conocimiento). El bot consulta solo los que necesita en cada respuesta.
Herramientas
En cada respuesta se le dice al bot la fecha y la hora en esta zona (por defecto, Europe/Madrid).
Herramientas propias (webhook)
Cada herramienta es una URL (un workflow de n8n, Make, Flowise…) que el bot puede llamar con los parámetros que declares. Comunica hace POST con { tool, args, bot, channel, contact }, firmado con el secreto del bot (X-Comunica-Signature), y le pasa al bot la respuesta. Nombres en minúsculas y _.
Separadas por comas. Las herramientas de etiquetas solo tocan estas; sin lista, ninguna. El traspaso a humano siempre puede poner «humano».
Vacío: la memoria es solo de este bot. Si varios bots de la misma entidad llevan la misma clave, comparten lo que recuerdan de cada persona (y conviene que usen la misma plantilla).
En Markdown; el bot la rellena y la mantiene al día. Vacía, se usa la del ejemplo. No pidas que guarde contraseñas ni datos de pago.
Con motor webhook, el conocimiento y las herramientas viven en el servicio externo.
Qué le falta
Valoraciones del equipo (👍 / 👎 en el chat), traspasos a una persona y búsquedas en los manuales sin resultado. Sirve para mejorar instrucciones, skills y manuales: el bot no cambia solo.
Últimas 50 intervenciones de este bot.
Conversación de prueba: no se envía a ningún canal ni toca contactos. Guarda el bot antes de probar cambios.
Conocimiento

Biblioteca reutilizable: cada conocimiento reúne instrucciones y manuales (PDF, Word, texto). Asígnalos a uno o varios bots; el bot decide cuándo consultarlos por su descripción.

Proveedores y modelos

Dónde viven las credenciales (Anthropic, OpenAI, Google, OpenRouter, Ollama…) y qué modelos pueden usar los bots.

Actividad

Últimas intervenciones de todos los bots: respuestas, saltos y errores.

Perfiles y permisos

Qué puede hacer cada perfil. Los perfiles se asignan en Usuarios.

Perfiles y permisos

Qué puede hacer cada perfil. Un usuario tiene uno o varios perfiles y suma sus permisos, siempre dentro de los canales a los que tiene acceso. Los ADMIN lo pueden todo. Los perfiles también sirven para dirigir avisos en las reglas.

Cambios sin guardar
Selecciona un grupo o créalo
Los grupos forman un árbol (Centro › Curso › Grupo). Sus responsables llevan a las personas del grupo y de sus subgrupos.

Reglas

Automatiza respuestas, seguimientos, etiquetas y avisos según lo que pase en cada conversación

API keys

Para clientes MCP (Claude Desktop, Cursor, agentes propios) e integraciones HTTP. Cada key hereda los permisos del usuario que la creó.

Una key, dos usos:
• MCP: cliente Claude/Cursor → /mcp con Authorization: Bearer comunica_xxx
• API REST: Zapier, n8n, scripts → cualquier /api/... con el mismo header (también X-API-Key)
Hereda los permisos del user que la creó. Documentación completa en docs/MCP.md.

Campañas

Envía un mensaje o plantilla a un grupo de contactos en un canal.

WhatsApp: a quien lleva más de 24 h sin escribirte solo se le puede enviar una plantilla aprobada por Meta. Para llegar a todos, elige como mensaje «Plantilla oficial WhatsApp».
Audiencia: una lista fija se calcula al lanzar y no cambia; una lista que se actualiza incluye también a quien cumpla el filtro mientras la campaña está en marcha.
Calendarios

Usuarios y permisos

Gestiona quién accede a la app y qué puede hacer en cada canal.

Skills para Claude

Para usar Comunica desde Claude (Claude Code, Claude Desktop…). La de mensajería la puede descargar todo el equipo desde su menú de usuario; la de administración, solo los administradores.

Roles: ADMIN hace todo. USER solo ve canales asignados.
Niveles por canal: Ver · Enviar (incluye Ver) · Gestionar (incluye todo, edita el canal).
Usuario Email Rol Estado Permisos por canal Acciones
Cargando…

Plugins

Extiende Comunica con código JS. Cada plugin se ejecuta en un sandbox aislado y puede suscribirse a eventos, registrar comandos slash y rutas HTTP.

Cargando…
📚 Referencia rápida del API

Los plugins reciben un objeto api con estas capacidades:

  • api.on(event, handler) — suscribirse a eventos. Eventos: message.inbound, message.outbound, message.status, message.reaction, contact.created, contact.updated.
  • api.registerCommand(slug, handler, { description }) — añade un comando slash /<slug> al composer.
  • api.registerRoute('GET'|'POST'|..., '/path', handler) — endpoint montado en /api/p/<plugin>/path.
  • api.sendMessage({ channelId, to, text|template|mediaId }) — enviar mensajes.
  • api.prisma — cliente Prisma (lectura/escritura).
  • api.fetch(axiosConfig) — cliente HTTP con timeout 15s.
  • api.logger — pino logger scoped al plugin.
  • api.settings.get() / api.settings.set(obj) — config persistente.

⚠️ No tienes require() ni filesystem. Sí: fetch, Promise, setTimeout, JSON, URL, Buffer.

📖 Documentación completa: docs/PLUGINS.md — guía paso a paso, catálogo de eventos, recetas y FAQ.

Nuevo plugin

Ajustes

Opciones globales de la instalación, por apartados.

Tu apariencia

Solo para ti: se guarda en tu usuario y se aplica en cualquier navegador donde entres. También puedes pedírselo al asistente («ponme el modo oscuro»).

Asistente del panel

El chat del botón de abajo a la derecha. Cada usuario lo usa con sus propios permisos: solo consulta y hace lo que él podría hacer en el panel, y todo lo que cambia algo (enviar, etiquetar, reglas, campañas…) le pide confirmación con un botón.

Los modelos salen de los proveedores de Bots IA. Conviene uno con buen uso de herramientas.
Cuántas herramientas puede encadenar antes de contestar. Más pasos = respuestas más completas y más coste.
El asistente recuerda de cada usuario sus preferencias y lo que suele hacer, entre conversaciones. Cada uno ve, corrige o borra la suya desde el asistente (botón del cerebro).

Lo que mandan los clientes se lee con IA: las notas de voz se transcriben y las fotos se describen (con el texto que se vea). La transcripción aparece en el chat y los bots la usan para contestar; si un bot va a responder, espera a tenerla. Los modelos son los de Bots IA y se llaman por la API compatible con OpenAI, así que puedes cambiar de modelo o de proveedor cuando quieras. En Bots IA, «Detectar» comprueba qué sabe hacer cada modelo.

Por ejemplo whisper-1 o gpt-4o-mini-transcribe (OpenAI), whisper-large-v3 (Groq) o un Whisper propio compatible con OpenAI. Sin idioma, lo detecta solo.
Sin IA ni coste: se extrae el texto. Un PDF escaneado no tiene texto.
Para que un bot conteste a audios o fotos, márcalos en su pestaña General («Responde a»).
Solo se lee automáticamente lo que llega a partir de ahora. Aquí puedes leer también los audios, fotos y documentos anteriores (con los modelos elegidos arriba, aunque el automático esté apagado). En el chat, cada uno tiene además su botón «Transcribir».
Usa lo que hay en pantalla, aunque no esté guardado. No se guarda nada.
Búsqueda en los manuales

Los manuales de los conocimientos se trocean por secciones y los bots buscan en ellos solo los fragmentos que necesitan. La búsqueda por palabras funciona siempre, sin configurar nada, y acierta con términos exactos (códigos, referencias, precios). Con un modelo de embeddings se añade la búsqueda por significado (pgvector), que acierta aunque se pregunte con otras palabras; las dos se combinan.

De los modelos de Bots IA. Tiene que ser de embeddings: text-embedding-3-small (OpenAI), gemini-embedding-001 (Google) o nomic-embed-text (Ollama). Al guardar se prueba. DeepSeek no ofrece embeddings.
Marca de la instalación

Título, subtítulo y logo que aparecen en la cabecera lateral. Personaliza la app con tu marca.

Prioridad: URL del logo > Emoji > icono por defecto.
💬
Multichannel
Messaging Hub
vista previa
Estado
cargando…
Configura tu cuenta ngrok

Pega tu authtoken para empezar. Lo encuentras en dashboard.ngrok.com.

cuenta
No se pudieron leer tus dominios ngrok vía API
Mientras tanto puedes usar los endpoints manuales de abajo o arrancar sin endpoint (ngrok asigna uno aleatorio).
Aún no has creado ningún endpoint.
Último dominio usado:
Conectar con ngrok

Pega tu API key (distinta del authtoken) y la app listará tus dominios reservados automáticamente. Sin esto tienes que crearlos a mano.

La API key se obtiene en dashboard.ngrok.com/api-keys.

Conectado. Tus dominios reservados aparecen automáticamente en el dropdown del túnel global de arriba — selecciona uno y pulsa Arrancar.
Sesiones activas

Procesos de agente conectados a ngrok. El plan free permite máx. 3 simultáneas — si tienes zombies de containers que crashearon, ocupan slot hasta cerrarlas.

cargando…
Endpoints ngrok

Cada endpoint = un dominio reservado de tu cuenta. Sincronízalos arriba con la API key, o créalos manualmente abajo.

Sólo necesario si este endpoint es de OTRA cuenta ngrok distinta. Lo normal es dejarlo vacío.
URLs públicas

Separadas por uso. Cualquier campo vacío hereda automáticamente de URL base (o, si está vacía, del túnel ngrok activo).

Dominio canónico donde se sirve el panel. Se usa para enlaces compartibles, emails y branding.

Dónde Meta / Telegram envían los webhooks de mensajes. Si tu servidor está detrás de túnel ngrok pero el panel está en otro dominio, pon aquí la URL del túnel.

Dominio que debe coincidir con App Domains / JSSDK Allowed Domains en tu app de Facebook. Normalmente es igual a la URL base.

Meta App

App ID + App Secret de tu app en Meta for Developers. Se usa para "Conectar con Meta" y para refrescar tokens automáticamente.

cargando…
Calendarios de Google y Outlook

Credenciales OAuth de tus apps en Google Cloud y en Microsoft Entra (Azure). Con ellas cada usuario conecta su cuenta desde Calendario y sincroniza en los dos sentidos. Ver docs/CALENDARIO.md.

Google Calendar …
Outlook / Microsoft 365 …
common: cuentas personales y de cualquier empresa; o el id de tu directorio para limitarlo a él.

Copias de seguridad

Se generan en el servidor y se descargan cuando terminan. Caducan a las 24 h.

Trata el fichero como una contraseña. Incluye los tokens de los canales, el App Secret y los secretos de sesión: quien lo tenga puede suplantar la instalación.
Esta imagen no trae pg_dump: solo funciona la copia de Configuración. Para las otras dos hay que reconstruir la imagen.
Privacidad
Tokens Meta

Estado y refresco de tokens de los canales WhatsApp / Facebook / Instagram. El sistema los refresca solo cada 6h cuando quedan ≤ 7 días — aquí puedes forzarlo o ver el estado.

Logs recientes

Últimos warnings y errores del servidor (en memoria, máx. 500). Útil para depurar errores 4xx/5xx desde la UI sin entrar al container.

Borrados

Registro de borrados destructivos (vaciar conversación, borrar contacto, borrar mensaje): quién, qué y cuándo. Cuando hay snapshot, se puede restaurar.

?
Contenido
Integración
Administración
Cuenta
Documentación API

Grupos y responsables

Grupos
La llevan directamente
Además la llevan los responsables de sus grupos y de los grupos por encima.

Nueva conversación

Enviar plantilla

Parámetros de la plantilla

Esta plantilla tiene variables que necesitan valor. Las sustituciones {{name}}, {{firstName}}… se resuelven al enviar.

Atajos de teclado

Enviar mensaje
Enter
Salto de línea
Shift + Enter
Comandos rápidos
/ en el mensaje
Mencionar contacto
@ en el mensaje
Cerrar diálogo o menú
Esc
Moverse por el diálogo
Tab / Shift+Tab
Mostrar esta ayuda
?

Filtro avanzado de etiquetas

Separadas por coma. Sugerencias al escribir.
Separadas por coma. Sugerencias al escribir.

Aplicar etiqueta

0 contacto(s) recibirán la etiqueta.

o

Emojis

Acción

Reglas en esta conversación

Activa o silencia cada regla individualmente para este contacto. Las reglas marcadas como "siempre activa" no aparecen aquí — corren siempre.

Mensaje con botones

El cliente verá tu pregunta y los botones. Al pulsar uno, su respuesta llegará como un mensaje normal y podrás engancharla a reglas.

Nuevo proveedor

Endpoint compatible con OpenAI (termina en /v1). En proveedores directos, déjalo vacío salvo que uses un proxy.

Nuevo modelo

Qué sabe hacer

Nuevo conocimiento

Es lo que lee el bot para decidir si lo consulta: describe la situación, no el contenido.
Manuales
PDF, Word, Excel, CSV, HTML, TXT o Markdown (máx. 15 MB), o una página web. El bot busca en ellos cuando le hacen falta. En Excel y CSV cada fila es una ficha (sirve para catálogos y preguntas frecuentes con columnas «Pregunta» y «Respuesta»).

Manual

Nueva API key

La clave se mostrará UNA sola vez. Cópiala y guárdala — no podrás recuperarla después.

⚠ Cópiala ahora

Esta clave NO se mostrará de nuevo. Guárdala en tu gestor de contraseñas o configuración del cliente MCP.
Snippet de configuración para Claude Desktop

      

Archivos de la conversación

Plantillas locales

Multicanal · escribe en texto plano o markdown · al enviar se adapta al formato nativo de cada plataforma.

Nueva plantilla

Pestañas por idioma — el texto por defecto se usa cuando el contacto no tiene un idioma con traducción. Escribe / para insertar variables.
Vista previa:
(pasa el ratón por cada icono)
Si hay botones → plantilla de respuesta rápida

Nuevo canal

Se configuran en Bots IA. Se pausa por conversación desde el chat.
Cada contacto nuevo recibe ficha en Personas y entra en este grupo. Es una bandeja común: lo ve todo el equipo hasta que se pasa a su grupo (a mano o con la regla «Pasar a grupo»).
Usuarios del chat

Marca los usuarios que tendrán acceso. Cada uno con su rol: Operador chatea "como el bot" y ve todos los threads; Contactable tiene su propio thread 1:1 con el bot.

cargando usuarios…
Exposición pública del webhook

    

Test de recepción

Envía un mensaje a este canal
Escribe a tu número/bot/página desde otra cuenta y aparecerá aquí.
Esperando mensaje… Timeout en 120s

      

Nueva regla

Menor número = se evalúa antes.
Imprescindible en las respuestas automáticas.
Invocación desde el chat
Si lo defines, la regla aparece en el dropdown / del composer y puede ejecutarse a mano.
Tras ejecutar, se renderiza con {{var}} contra el contexto (incluye as: de cada acción) y el resultado se inserta en el composer.
Condiciones

Sin condiciones, la regla se ejecuta siempre que llegue el disparador. Los grupos permiten «A y (B o C)». El campo admite cualquier ruta del contexto (p. ej. message.raw.button_id).

Condiciones con IA. Escribe el tema en lenguaje normal (p. ej. «pide un presupuesto o pregunta precios») y un modelo decide si el mensaje trata de eso, aunque use otras palabras, tenga faltas o esté en otro idioma. Solo se le pregunta cuando su respuesta cambia el resultado, y la traza de cada ejecución dice qué decidió y por qué.
Acciones

Los envíos van al contacto del evento: solo dentro de la ventana de 24 h (fuera, usa una plantilla), nunca a mensajes de hace más de 15 min y como mucho 10 por contacto y hora entre todas las reglas.

Probar sin ejecutar

Crear desde receta

La regla se crea desactivada: revísala, pruébala y actívala.

Versiones

Esperas

Acciones que esperan a que venza su plazo (acción «Esperar»).

Historial de ejecuciones

Usuarios

Editar usuario

Perfiles
Suma los permisos de cada perfil (Usuarios → Perfiles). También sirven para dirigir avisos desde las reglas.
Acceso a canales

Cambiar contraseña

Validar webhook

Nueva persona

Se reconoce cuando escribe por un canal y puede recibir avisos de las reglas. Si el email coincide con el de un usuario, se vincula solo.
Vincula esta persona con sus contactos en cada canal. Si no existe, se crea automáticamente.

Vincular contacto a persona

Credenciales de Meta App

Datos de tu app en Meta for Developers. El secreto se guarda cifrado en BD y nunca se expone.

Se obtiene en Meta dashboard → WhatsApp → Configuración → Embedded Signup.

Selecciona la cuenta a conectar

¿Qué quieres conectar?

¿Error "JSSDK no activado"? Tu app de Meta necesita habilitar el login con JavaScript SDK. .

Destinatarios

Empieza
Termina
Termina veces
Más opciones

Nuevo calendario

Color
Origen
Compartir con grupos

Lo ven los responsables del grupo (y quien les suple) y los miembros del equipo. «Subgrupos» lo extiende a los que cuelgan de él.

Suscribirse e intercambiar
Enlace privado (.ics)
Para verlo en Google Calendar, Outlook o el iPhone. Quien tenga el enlace ve los eventos.
Exportar .ics

Destinatarios

Nueva campaña

Separadas por coma. Se añaden a cada contacto de la campaña al procesarlo (no reemplazan sus etiquetas).

Mensaje

Escribe / para insertar variables como {{name}}, {{firstName}}, {{phone}}…
No hay plantillas sincronizadas para este canal. Ve a Plantillas y pulsa «Sincronizar».
En WhatsApp solo puedes iniciar conversación con una plantilla oficial. Un texto o snippet solo llegará a contactos que te escribieron en las últimas 24h. Para llegar a toda la audiencia, elige «Plantilla oficial WhatsApp» como tipo de mensaje.

Audiencia

Separadas por coma. Sugerencias al escribir.
Separadas por coma. Sugerencias al escribir.
Opcional. Ctrl/Cmd + clic para elegir varios. Se combina con las etiquetas.
No hace falta que sean contactos guardados: se enviará a todos los números de la lista.
Estimación: — destinatarios

Plantilla de reapertura (Messenger e Instagram)

Para Messenger/Instagram: cuando un destinatario está fuera de la ventana, primero se envía esta plantilla y, opcionalmente, después el mensaje principal. En WhatsApp no aplica (enviar una plantilla no abre la ventana de 24h): usa el tipo «Plantilla oficial WhatsApp» como mensaje.

Etiquetas condicionales (opcional)

Separadas por coma. Se añaden al contacto además de las etiquetas generales, según el resultado del envío.

Falta configurar tu app de Meta

"Login con SDK de JavaScript" no está activado

Para que el botón "Conectar con Meta" funcione, ve a tu app en developers.facebook.com y activa la opción "Inicio de sesión con el SDK de JavaScript".

Abrir la configuración de mi app
1. Inicio de sesión con Facebook → Configuración
  • Inicio de sesión con OAuth del cliente → Sí
  • Inicio de sesión con OAuth de la web → Sí
  • Inicio de sesión con el SDK de JavaScript → Sí (este es el que está fallando)
2. Añade tu dominio
En el mismo formulario, en Dominios de JavaScript permitidos añade tu dominio actual:
También añade el dominio completo en URI de redireccionamiento del OAuth válido:
3. Configuración básica
  • En Configuración → Básica, añade el dominio en Dominios de la app.
  • Si la app está en modo Desarrollo, solo administradores/probadores podrán hacer login. Añade testers en Roles o pasa a modo Live.
Tras guardar los cambios en Meta, vuelve aquí y reintenta el botón "Conectar con Meta". Los cambios suelen ser inmediatos.

Detalles del archivo

Descripción
Transcripción
Editar transcripción
Este archivo no tiene transcripción ni descripción. Edita el media o usa la API PATCH /api/media/:id para añadirlas.

Markdown en el chat

El servidor lo traduce al formato nativo de cada plataforma
Qué quieres Escribes Sale en chat
Negrita**hola**hola
Cursiva_hola_hola
Tachado~~hola~~hola
Código`código`código
Bloque de código```
let x = 1
```
let x = 1
Lista- uno
- dos
- tres
• uno
• dos
• tres
Lista numerada1. uno
2. dos
1. uno
2. dos
Cita> holahola
Enlace[texto](https://url)texto
Variables{{name}}Se sustituye con el nombre del contacto al enviar
💬 WhatsApp
Formato propio nativo: *b* _i_ ~s~
✈️ Telegram
HTML nativo (parse_mode=HTML) con todo el formato.
📘 Messenger
Texto plano. Se quitan las marcas (no soporta formato).
📷 Instagram
Texto plano. Se quitan las marcas (no soporta formato).
El indicador ✦ markdown debajo del input se enciende automáticamente cuando detecta marcas. Si solo escribes texto plano, no se aplica nada.

Comunica v…

Historial de cambios

Cargando…

Apariencia

Solo para ti. Se guarda en tu usuario.

Skills para Claude

Descarga el zip, copia la carpeta en tus skills de Claude y conecta el MCP con tu API key: dentro va un INSTALAR.txt con los pasos y la dirección de esta instalación.

Asistente