Mensajería

Envía mensajes a individuos, equipos o canales a través de Dailybot. El endpoint send-message maneja texto, imágenes, botones, respuestas en hilo, impersonación del bot y edición en el mismo POST. Los mensajes se entregan en la plataforma conectada por tu organización (Slack, Microsoft Teams, Discord o Google Chat).

Enviar Mensaje

curl -X POST "https://api.dailybot.com/v1/send-message/" \
  -H "X-API-KEY: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Despliegue completado exitosamente! ✅",
    "target_users": ["a1b2c3d4-e5f6-7890-abcd-ef1234567890"],
    "target_teams": ["b2c3d4e5-f6a7-8901-bcde-f12345678901"]
  }'

{
  "bot_message_id": "$db/ae007b43-dde2-4fa9-bce3-71fb0975a249"
}

{
  "detail": "cli_send_message_target_not_allowed",
  "code": "cli_send_message_target_not_allowed"
}

Respuestas en hilo

Dos formas de armar hilos. Pasa `thread_responses` (hasta 10) para publicar un padre más respuestas en una sola llamada. Los IDs de respuesta vienen en el response para editarlos después.

Para responder dentro de un hilo existente, usa la forma de objeto de `target_channels` y define `thread` como el timestamp/id del mensaje padre.

curl -X POST "https://api.dailybot.com/v1/send-message/" \
  -H "X-API-KEY: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Release 4.12.0 saliendo ya.",
    "target_channels": ["C0123456789"],
    "thread_responses": [
      {"message": "Frontend: build en verde"},
      {"message": "Backend: migraciones OK"},
      {"message": "Changelog completo: https://acme.example/rel/4.12.0"}
    ]
  }'

curl -X POST "https://api.dailybot.com/v1/send-message/" \
  -H "X-API-KEY: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Un detalle: activa el feature flag \"nav_v2\" primero.",
    "target_channels": [
      { "id": "C0123456789", "thread": "1710000000.123456" }
    ]
  }'

{
  "bot_message_id": "$db/ae007b43-dde2-4fa9-bce3-71fb0975a249",
  "thread_responses": [
    "$db/thread-1",
    "$db/thread-2",
    "$db/thread-3"
  ]
}

Impersonación del bot (Slack)

`platform_settings.bot_username` junto con `bot_icon_url` O `bot_icon_emoji` cambian la apariencia del bot para ese mensaje. Solo Slack hoy — otras plataformas ignoran el bloque y usan la identidad del bot conectado.

curl -X POST "https://api.dailybot.com/v1/send-message/" \
  -H "X-API-KEY: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Deploy de 4.12.0 en producción ✅",
    "target_channels": ["C0123456789"],
    "platform_settings": {
      "bot_username": "Release Bot",
      "bot_icon_emoji": ":rocket:"
    }
  }'

Editar un mensaje

Reenvía la petición con el mismo `bot_message_id` dentro de **72 horas** para editar el original. Funciona tanto en el padre como en cualquiera de los IDs devueltos en `thread_responses`.

curl -X POST "https://api.dailybot.com/v1/send-message/" \
  -H "X-API-KEY: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "bot_message_id": "release-4.12.0",
    "message": "Deploy de 4.12.0 — rollback en curso ⚠️",
    "target_channels": ["C0123456789"]
  }'

Mensajes ephemeral (Slack)

Define `platform_settings.is_ephemeral: true` junto con `target_users` para publicar un mensaje dentro del canal que solo esos usuarios ven. Solo Slack; otras plataformas lo tratan como mensaje normal.

curl -X POST "https://api.dailybot.com/v1/send-message/" \
  -H "X-API-KEY: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Aviso: tu turno de on-call empieza en 10 minutos.",
    "target_channels": ["C0123456789"],
    "target_users": ["a1b2c3d4-e5f6-7890-abcd-ef1234567890"],
    "platform_settings": { "is_ephemeral": true }
  }'

Identidad personalizada con send_as_user (solo Slack)

send_as_user permite que una llamada autorizada publique un mensaje que aparece como si viniera de otro usuario — el mensaje muestra el nombre y avatar del usuario destino en lugar de la identidad del bot de Dailybot.

El mensaje se entrega igualmente a través del token del bot de Dailybot (no usa el token de Slack del usuario destino), por lo que respeta el acceso a canales del bot y las reglas de atribución de mensajes de Slack.

• El llamante debe ser admin de la organización (o tener una key cuyo owner sea admin).
• El usuario objetivo (send_as_user UUID) debe estar activo y en la misma organización.
• Solo Slack — otras plataformas ignoran el campo y usan la identidad normal del bot.
• send_as_user es mutuamente exclusivo con bot_username, bot_icon_url y bot_icon_emoji.

curl -X POST "https://api.dailybot.com/v1/send-message/" \
  -H "X-API-KEY: $DAILYBOT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "El sprint está cerrado y todos los tickets resueltos.",
    "target_channels": ["C0123456789"],
    "send_as_user": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }'

Casos de uso

• Resúmenes automáticos de standups publicados con el nombre del miembro del equipo.
• Recordatorios de check-in generados por IA atribuidos al manager.
• Salidas de flujos de trabajo atribuidas al usuario que los disparó.

Scoping por rol del CLI

Cuando quien llama es un usuario autenticado por CLI (no una API key de máquina), Dailybot aplica scoping por rol: admins y managers pueden apuntar a cualquier usuario/equipo/canal público; miembros de equipo pueden apuntar a compañeros de sus equipos compartidos y a canales públicos; invitados solo pueden mandarse mensajes a sí mismos. Fuera de ese scope el endpoint devuelve 403 con `cli_send_message_target_not_allowed`.

Enviar Email

curl -X POST "https://api.dailybot.com/v1/send-email/" \
  -H "X-API-KEY: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "users_uuids": ["a1b2c3d4-e5f6-7890-abcd-ef1234567890"],
    "email_subject": "Reporte Semanal Listo",
    "email_content": "Tu reporte semanal del equipo está disponible. Revisa tu dashboard."
  }'

{
  "detail": "Emails sent successfully."
}

{
  "detail": "one_or_more_users_not_found",
  "code": "one_or_more_users_not_found"
}

{
  "detail": "Invalid or missing API key.",
  "code": "authentication_failed"
}

Abrir Conversación

curl -X POST "https://api.dailybot.com/v1/open-conversation/" \
  -H "X-API-KEY: tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "users_uuids": [
      "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "b2c3d4e5-f6a7-8901-bcde-f12345678901"
    ]
  }'

{
  "channel": "C0123456789"
}

{
  "detail": "one_or_more_users_not_found",
  "code": "one_or_more_users_not_found"
}

{
  "detail": "Invalid or missing API key.",
  "code": "authentication_failed"
}