Sáltate la instalación. Funcionando en menos de 2 minutos.
Inicia una prueba gratuita en cloud.anythingmcp.com, añade Viber Bot con un clic y apunta tu cliente de IA (Claude, ChatGPT, Copilot o Cursor) al endpoint MCP generado. Sin Docker, sin git clone, sin experiencia de desarrollo.
Resumen
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.
Prueba a pedir
Prompts de ejemplo para Viber Bot
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿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 + Microsoft Copilot
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.
- 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.
- 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.
- Pégalo en
VIBER_AUTH_TOKEN, instala el conector y ejecutaviber_get_account_infopara comprobarlo. - 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 Microsoft Copilot
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 muestraYOUR_SERVER_ID.
Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.
- En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
- Escribe un Server name (por ejemplo
AnythingMCP), una Server description que diga qué hace el conector y la Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor. - En la autenticación, elige API key, pon Type en Header y
X-API-Keycomo nombre de la cabecera, y selecciona Create. - En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
- Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de
Viber Bot. - Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.
¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.
¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.
Herramientas disponibles
| Tool | What it does |
|---|---|
viber_get_account_info | Details of the bot account: id, name, uri, icon, category, country, the webhook URL and its event_types, and subscribers_count |
viber_get_user_details | Details of one subscribed user: name, avatar, country, language, primary device OS, device type, Viber and API version |
viber_get_online | Online status of up to 100 subscribed users. online_status: 0 online, 1 offline (with last_online in Unix ms), 2 hidden by the user, 3 try… |
viber_send_text | Send a text message (up to 7,000 characters) to one subscribed user, optionally with a keyboard of reply buttons |
viber_send_picture | Send a picture (JPEG, PNG or static GIF from a URL) with a caption to one subscribed user |
viber_send_video | Send an MP4 video (H.264, up to 26 MB and 180 seconds) from a URL to one subscribed user |
viber_send_file | Send a file (up to 50 MB, from a URL) to one subscribed user, e.g. a PDF invoice |
viber_send_url | Send a link (up to 2,000 characters) to one subscribed user; Viber shows a preview |
viber_send_contact | Send a contact card (name and phone number) to one subscribed user |
viber_send_location | Send a location pin (latitude and longitude) to one subscribed user |
viber_send_sticker | Send a Viber sticker by its numeric sticker id to one subscribed user |
viber_send_rich_media | Send a rich media message (a carousel of cards with images, text and buttons) to one subscribed user |
viber_broadcast_message | Send the same message to up to 300 subscribed users in one call |
viber_set_webhook | Set the bot's webhook, the HTTPS endpoint where Viber delivers incoming messages and events |
viber_remove_webhook | Remove the bot's webhook |
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
¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.
¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.
El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.
Siguientes pasos
- Página del conector
- Conectar a Claude
- Conectar a ChatGPT
- Conectar a Cursor
- Conectar a Gemini
- Conectar a Meta Muse
¿Te ha sido útil esta guía?