Cómo conectar Viber Bot a ChatGPT vía MCP

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Viber Bot, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Viber Bot + ChatGPT

Envía mensajes de Viber desde un bot de Viber a través de la Viber REST Bot API: texto con teclados, imágenes, vídeos, archivos, enlaces, contactos, ubicaciones, stickers y carruseles rich media, difusiones a hasta 300 suscriptores, datos y estado en línea de los suscriptores, y el webhook del bot. Token de autenticación del bot.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

VIBER_AUTH_TOKEN

Paso 1 — Obtener credenciales

La configuración lleva unos 5 minutos una vez que tienes un bot.

1. Necesitas un bot de Viber ya existente. Desde el 5 de febrero de 2024 Viber solo crea bots nuevos en condiciones comerciales: solicítalo a través de Rakuten Viber o de uno de sus partners oficiales (consulta https://developers.viber.com/docs/api/rest-bot-api/). Los bots gratuitos más antiguos siguen funcionando.
2. Copia el token de autenticación del bot (app key): en la app de Viber, como admin del bot, en More > Settings > Bots > Edit Info > Your app key, o en el Viber Admin Panel.
3. Pégalo en VIBER_AUTH_TOKEN, instala el conector y ejecuta viber_get_account_info para comprobarlo.
4. Viber solo permite a un bot escribir a los usuarios cuando tiene un webhook configurado. Si tu bot aún no tiene, configura uno con viber_set_webhook: la URL debe responder a la comprobación de Viber con HTTP 200 y tener un certificado de una CA de confianza.

El conector envía; no recibe. Viber entrega los mensajes y eventos entrantes solo al webhook del bot, un endpoint HTTPS público propio.

Quién puede recibir mensajes: solo los usuarios suscritos al bot. Un usuario se suscribe escribiendo al bot o pulsando suscribirse, y puede darse de baja en cualquier momento. No hay ninguna API para listar suscriptores: sus id de usuario llegan al webhook, así que el id al que envía la IA tiene que venir de ahí. Enviar a cualquier otra persona falla con receiverNotSubscribed (6) o receiverNotRegistered (5). Escribir a personas por número de teléfono es otro producto, de pago (Viber Business Messages), y no forma parte del conector.

Qué envía: a un suscriptor, texto de hasta 7.000 caracteres (opcionalmente con un teclado de botones de respuesta), imágenes, vídeos, archivos, enlaces, tarjetas de contacto, ubicaciones, stickers y carruseles rich media de tarjetas con imágenes y botones. Cada envío lleva el id de usuario del destinatario y un nombre de remitente de como máximo 28 caracteres. viber_broadcast_message envía el mismo mensaje a hasta 300 suscriptores por llamada, rellena el nombre o el id de cada destinatario donde el texto lo pide y lista los destinatarios que no lo recibieron.

Qué lee: la cuenta del bot con su webhook, tipos de evento y número de suscriptores; el nombre, país, idioma, dispositivo y versión de Viber de un suscriptor (como máximo dos veces por usuario cada 12 horas); y el estado en línea de hasta 100 suscriptores. También puede configurar o eliminar el webhook; eliminarlo cierra el chat 1 a 1 del bot para los usuarios.

Confirma antes de enviar: cada mensaje llega a una persona real, y los bots comerciales pagan por los mensajes fuera de una sesión abierta por el usuario. La IA muestra el texto y los destinatarios y espera tu sí.

Formatos: cada respuesta tiene status (0 = ok) y status_message, y cualquier otro estado vuelve como error. Un mensaje enviado devuelve message_token. Un billing_status de 0 a 4 significa sin cargo, 5 un mensaje cobrado fuera de una sesión. Las horas son milisegundos Unix.

Límites: una solicitud debe quedar por debajo de 30 KB. Las imágenes son JPEG, PNG o GIF estático de hasta 1 MB en iOS (3 MB en Android) con la extensión en la URL, los vídeos MP4 de hasta 26 MB y 180 segundos, y los archivos de hasta 50 MB (los ejecutables se rechazan). Las difusiones admiten 500 solicitudes en 10 segundos. freeMessagesExceeded (23) o noBalance (24) significa que se han agotado los mensajes gratuitos del mes o el saldo.

Errores comunes (status): 2 token no válido, 5 destinatario sin Viber, 6 destinatario no suscrito, 7 bot bloqueado, 9 bot suspendido, 10 sin webhook configurado, 11 versión de Viber del destinatario demasiado antigua, 12 demasiadas solicitudes, 21 país no admitido.

El conector no recibe ni lee mensajes entrantes, no lista suscriptores y no envía mensajes a números de teléfono.

Paso 2 — Instalar el adapter

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 3 — Añadir el conector en ChatGPT

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

ChatGPT añade servidores MCP como plugins desde su página Plugins, en la web y en los planes de pago. Ya no hace falta el modo desarrollador. En un espacio Business solo pueden hacerlo los administradores y propietarios; en Enterprise y Edu un administrador puede conceder el permiso Create plugins with MCPs.

1. Ve a chatgpt.com/plugins, pulsa Add y luego Add custom MCP server.
2. Escribe un nombre, por ejemplo Name: Viber Bot.
3. En Connection, introduce como Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID y deja Authentication en OAuth.
4. Selecciona I understand and want to continue y después Create as a plugin. Cuando ChatGPT lo pida, inicia sesión en AnythingMCP y permite el acceso.
5. Instala el nuevo plugin desde tus plugins personales; luego escribe @ en un chat y elígelo.

Herramientas disponibles

Ejemplos de prompts

• "¿Cuántos suscriptores tiene mi bot de Viber y qué webhook usa?"
• "Envía al suscriptor 01234567890A== el texto: Tu pedido ya está en camino. Añade los botones de respuesta Sí y No."
• "Envía por difusión nuestro horario de fin de semana a estos 120 id de suscriptor y luego dime cuáles fallaron."
• "¿Cuáles de estos 20 suscriptores están en línea ahora mismo?"
• "Envía un carrusel de tres productos, cada uno con una imagen, un precio y un botón Comprar que abra la página del producto."

FAQ

¿Funciona el plan gratuito de ChatGPT con servidores MCP personalizados? OpenAI documenta los servidores MCP personalizados solo para los planes de pago; el plan Free no aparece en su lista.

Siguientes pasos

• Página del conector
• Conectar a Claude
• Conectar a Cursor
• Conectar a Gemini
• Conectar a Meta Muse
• Conectar a Microsoft Copilot