Cómo crear un bot en GoMsg para desarrolladores

Paso 1. Crea un bot en la interfaz

Abre GoMsg con tu cuenta. Ve a Business → Bots. Pulsa + o “Create bot”.

Rellena:

• Name — el nombre del bot (por ejemplo, ReminderBot)
• Description — qué hace el bot
• Avatar URL — avatar (opcional)
• Visibility — public (cualquiera puede añadirlo) o private (solo tú)

Tras crearlo obtendrás un Bot Token — una cadena larga como bot_a1b2c3d4e5f6.... Guárdalo en un lugar seguro: lo necesitarás para todas las llamadas a la API.

Paso 2. Añade el bot a un chat

Para que el bot pueda responder a un usuario, hay que añadirlo a un chat. Crea un chat nuevo o abre uno existente, pulsa “Add member” → selecciona tu bot.

El bot aparecerá en la lista de miembros con la etiqueta BOT.

Paso 3. Verifica la conexión

Una petición sencilla para comprobar que el token funciona:

curl https://your-server.com/api/bots/<TOKEN>/me

Como respuesta recibirás un JSON con la información del bot:

{
  "id": "12345678-...",
  "name": "ReminderBot",
  "is_active": true,
  "owner_id": "tu-user-id"
}

Paso 4. Envía el primer mensaje

Usa el método sendMessage:

curl -X POST https://your-server.com/api/bots/<TOKEN>/sendMessage \
  -H "Content-Type: application/json" \
  -d '{"chat_id": "ID-DEL-CHAT", "content": "¡Hola desde el bot!"}'

En el chat aparecerá un mensaje del bot. ¡Enhorabuena — acabas de enviar tu primer mensaje a través de la Bot API!

Paso 5. Configura el webhook

Para que el bot reaccione a los mensajes de los usuarios necesitas un webhook. Es una URL en tu servidor a la que GoMsg enviará los mensajes entrantes.

En la interfaz del bot (Business → Bots → tu bot), indica la Webhook URL:

https://your-bot-server.com/webhook

Cada mensaje del chat llegará allí como una petición POST:

{
  "id": "msg-id",
  "chat_id": "chat-id",
  "sender_id": "user-id",
  "sender_username": "ivan",
  "content": "/help",
  "message_type": "text"
}

Paso 6. Comandos del bot

Registra los comandos en la interfaz del bot. Por ejemplo: /help, /remind, /status. Después, los comandos aparecerán en el autocompletado mientras escribes.

En el lado del servidor webhook, gestiona el comando:

if (message.content.startsWith("/help")) {
  sendMessage({
    chat_id: message.chat_id,
    content: "Comandos disponibles:\n/help — ayuda\n/remind — recordatorio\n/status — estado"
  });
}

Ejemplo de bot en Node.js

Un servidor Express mínimo para un bot eco:

const express = require("express");
const app = express();
app.use(express.json());

const TOKEN = "bot_a1b2c3...";
const SERVER = "https://your-gomsg-server.com";

app.post("/webhook", async (req, res) => {
  const msg = req.body;

  // Eco: repetimos lo que escribió el usuario
  await fetch(`${SERVER}/api/bots/${TOKEN}/sendMessage`, {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      chat_id: msg.chat_id,
      content: `Dijiste: ${msg.content}`
    })
  });

  res.sendStatus(200);
});

app.listen(3000, () => console.log("Bot listening on :3000"));

Qué pueden hacer los bots de GoMsg

• send_message — enviar texto, foto, nota de voz
• edit_message — editar un mensaje
• delete_message — eliminar
• append_message — añadir a un mensaje (para streaming)
• reactions — poner reacciones
• commands — comandos slash personalizados
• visibility — público o privado
• permissions — permisos granulares (read, send, edit)

Ideas para bots

• Recordatorios. El usuario escribe “recuérdame llamar a mamá en una hora” — el bot envía el recordatorio.
• Moderación. Elimina spam y palabras malsonantes en un chat de grupo.
• Notificaciones CI/CD. El bot publica en un chat del equipo cuando falla un build en GitLab.
• Soporte. Un autorespondedor para el chat en vivo de un sitio web.
• Juegos. Aventuras de texto, trivial, ajedrez.
• Traductor. Cualquier mensaje → traducido a otro idioma.

Preguntas frecuentes

Qué viene ahora

El bot ya está creado. Si quieres ampliar su funcionalidad, despliega tu propio servidor GoMsg para tener control total, o conecta el bot a un widget de chat en tu sitio web.