Muetext logo Muetext

Configurar canales

Puentes con Telegram, WhatsApp, Slack y Discord: configuración, consentimiento, STOP y variables de entorno.

Cómo funcionan los puentes

Abre una conversación y ve a Participantes → Canales conectados. Telegram y WhatsApp suman al chat a una persona que no está en Muetext; Slack y Discord reflejan el chat en un canal del equipo.

Rigen las mismas reglas que en el puente SMS: cada copia pasa por una cola duradera (nunca se envía en línea), cada decisión de envío, STOP y START queda en un registro de consentimiento que solo crece, y un chat o una cuenta se vincula solo cuando alguien envía un código de un solo uso desde allí. A Telegram y WhatsApp solo llegan mensajes escritos por personas; lo que publican los bots se queda en la app. Los reflejos en Slack y Discord muestran todo lo publicado en la conversación.

Sin configurar = apagado

Cada puente sigue apagado hasta que sus credenciales estén en el servidor. Sin ellas el panel muestra "no configurado", el webhook responde 503 y no se envía nada. Los reflejos en Discord publican en un webhook que pegas tú y no necesitan credenciales del servidor.

# Telegram
TELEGRAM_BOT_TOKEN=123456:ABC…        # de @BotFather
TELEGRAM_WEBHOOK_SECRET=<aleatorio, 32+ caracteres>

# WhatsApp Cloud API
WHATSAPP_TOKEN=<token permanente de usuario del sistema>
WHATSAPP_PHONE_ID=<id del número>
WHATSAPP_APP_SECRET=<secreto de la app>  # firma los webhooks (X-Hub-Signature-256)
WHATSAPP_VERIFY_TOKEN=<aleatorio>        # verificación de la suscripción
WHATSAPP_TEMPLATE=muetext_new_message    # opcional
WHATSAPP_TEMPLATE_LANG=es                # opcional

# Slack
SLACK_BOT_TOKEN=xoxb-…
SLACK_SIGNING_SECRET=<secreto de firma>

# Discord (solo para el endpoint de interacciones)
DISCORD_PUBLIC_KEY=<clave pública de la aplicación, hex>

Telegram

Crea un bot con @BotFather, define las dos variables y apunta Telegram a Muetext con el mismo secreto. Telegram lo devuelve en X-Telegram-Bot-Api-Secret-Token en cada actualización; lo que llegue sin él recibe 401.

Para invitar: elige Invitar un chat de Telegram y envía el enlace. Al tocar Iniciar se envía el código y su chat se une a la conversación (ese toque es su consentimiento). Usa el enlace de grupo para conectar un grupo entero.

curl "https://api.telegram.org/bot$TELEGRAM_BOT_TOKEN/setWebhook" \
  -d url=https://muetext.com/api/channels/telegram \
  -d secret_token=$TELEGRAM_WEBHOOK_SECRET \
  -d 'allowed_updates=["message"]'

WhatsApp

En la consola de desarrolladores de Meta añade WhatsApp y suscribe el webhook a messages con la URL https://muetext.com/api/channels/whatsapp y tu WHATSAPP_VERIFY_TOKEN. Cada POST se comprueba con X-Hub-Signature-256.

Para invitar: elige Invitar un número de WhatsApp y envía el enlace wa.me. Abre WhatsApp con JOIN y un código; enviarlo es su consentimiento.

WhatsApp solo permite mensajes libres durante 24 horas desde el último mensaje de la persona. Fuera de esa ventana Muetext envía una plantilla aprobada que dice quién escribió (nunca el texto) y guarda los mensajes hasta que responda. Crea una plantilla de utilidad llamada muetext_new_message con una variable, por ejemplo: "Tienes un mensaje nuevo de {{1}} en Muetext. Responde aquí para leerlo. Responde STOP para darte de baja."

Slack

Crea una app de Slack con los permisos de bot chat:write, channels:history, groups:history, im:history, channels:read y groups:read. Activa Event Subscriptions con la URL https://muetext.com/api/channels/slack y suscríbete a message.channels, message.groups y message.im. Activa Interactivity con la misma URL. Instálala y define las dos variables. Las peticiones se comprueban con la firma v0 de Slack y se rechazan pasados cinco minutos.

Reflejar una conversación (administradores del espacio): elige Reflejar en un canal de Slack, invita la app al canal y publica allí link CÓDIGO.

Aprobaciones: los borradores de bots aparecen como tarjetas con Aprobar y Rechazar. Un clic solo cuenta si la cuenta de Slack está vinculada a un miembro de Muetext de esa conversación (Mis cuentas vinculadas → Verificar y envía verify CÓDIGO por mensaje directo a la app). La decisión pasa los mismos controles que en la app y la auditoría registra a ese miembro. Los mensajes de miembros vinculados se publican a su nombre; los demás se ignoran.

Discord

Reflejar una conversación (administradores del espacio): en Discord abre Ajustes del servidor → Integraciones → Webhooks, crea uno para el canal, copia la URL y pégala en Canales conectados. El reflejo es de solo lectura y nunca menciona a @everyone ni a roles. La URL se guarda solo en el servidor.

Para futuros botones, configura la Interactions Endpoint URL de la aplicación como https://muetext.com/api/channels/discord y DISCORD_PUBLIC_KEY; las peticiones se verifican con Ed25519.

STOP y consentimiento

STOP, STOPALL, UNSUBSCRIBE, CANCEL, END, QUIT, PARA, ALTO, BAJA o CANCELAR (también /stop en Telegram) detienen al instante todo lo que va a ese chat desde cualquier conversación, con una sola confirmación. START, UNSTOP o REANUDAR lo reanudan. Bloquear el bot o borrar el webhook cuenta como STOP. Cada cambio publica un mensaje de sistema en la conversación y queda en el registro de consentimiento; los miembros pueden leer las entradas de sus conversaciones.