Blog · Developers
Que tu bot o tu servidor MCP agende eventos en el calendario del chat
Cada chat de Puentes tiene su calendario: un evento con nombre, día, hora y lugar, una tarjeta donde cada uno contesta Voy, Tal vez o No voy, y los avisos que elige cada persona. Ahora tu bot o tu servidor MCP también puede armar esos eventos. Si tu servicio sabe de turnos, partidos o vencimientos, el evento queda en el chat de tu gente sin que nadie lo copie a mano.
Desde un bot externo
Con el token pb_ de tu bot, un POST con la misma forma que el formulario de la app:
curl -X POST https://app.puentes.ai/api/groups/<chatId>/events \
-H "Authorization: Bearer pb_…" -H "Content-Type: application/json" \
-d '{ "title": "Partido vs. Boca", "date": "2026-12-20", "time": "17:00",
"place": "Cancha 2", "remind": ["1d", "1h"] }'
La hora es la del reloj: Puentes le aplica la zona del chat. Sin time, el evento es de día entero. La tarjeta sale en el chat como un mensaje de tu bot.
Lo que tenés que saber:
- Tu bot arma el evento como sí mismo, y solo en chats donde escriben todos. En un grupo donde solo escriben los admins, responde
403. - Cambia (
PATCH /api/events/:id) o cancela (POST /api/events/:id/cancel) solo los que armó él. Un evento que armó una persona no lo toca. - Lee los eventos de sus chats con
GET /api/groups/:id/events. No contesta Voy ni tiene avisos propios: eso es de las personas. - Para no llenar de alarmas a nadie: hasta 10 eventos por venir en cada chat, como mucho 2 avisos sugeridos por evento, 10 eventos nuevos por hora y 20 cambios por hora, sumando todos sus chats.
Desde un servidor MCP
Tu herramienta no escribe en el calendario: se lo pide a Puentes en el resultado de tools/call, con _meta.puentes.event (uno o una lista, hasta 3 por respuesta):
"_meta": { "puentes": { "event": {
"title": "Partido vs. Boca", "date": "2026-12-20", "time": "17:00",
"place": "Cancha 2", "remind": ["1d", "1h"]
} } }
Puentes lo arma a nombre de la persona que le escribió a la IA, con sus permisos, y la tarjeta sale debajo de la respuesta. Con op también lo cambiás ("change") o lo cancelás ("cancel"), siempre que lo haya armado esa misma IA. Si la IA vuelve a armar uno con el mismo nombre el mismo día, se cambia en vez de duplicarse.
Solo vale cuando una persona lo pidió en ese mensaje: no desde un callbackUrl, un recordatorio, una rutina u otra IA. Y no se arma desde una herramienta que pide confirmación: devolvé el evento desde una que no la pida.
Por qué con topes
Cada evento le manda avisos a todo el chat, y un aviso suena aunque el chat esté silenciado. Por eso el server pone los límites y arma solo lo que alguien pidió. Armá solo los eventos que tu gente necesita.
El detalle está en la documentación: el contrato de _meta.puentes.event y las rutas de eventos. Si todavía no conectaste tu servidor, empezá por conectar un servidor MCP a un agente.