Mensajería

Envía mensajes a individuos, equipos o canales a través de Dailybot. Estos endpoints soportan mensajes de texto, imágenes, botones y envío de email. Los mensajes se entregan a través de la plataforma que usa tu organización (Slack, Microsoft Teams, Google Chat o el chat nativo de Dailybot).

Método	Endpoint	Descripción
POST	/v1/send-message/	Enviar un mensaje a usuarios, equipos o canales
POST	/v1/send-email/	Enviar un email a usuarios por UUID
POST	/v1/open-conversation/	Crear una conversación grupal privada

Enviar Mensaje

POST /v1/send-message/

Envía un mensaje a los usuarios, equipos o canales especificados. Debe proporcionarse al menos un destino (usuarios, equipos o canales).

Parámetros del Cuerpo

Name	Type	Required	Description
`message`	string	Optional	Texto del mensaje (HTML seguro). Requerido si messages no se proporciona.
`messages`	array	Optional	Mensajes específicos por plataforma. Requerido si message no se proporciona.
`target_users`	array of strings (UUID)	Optional	UUIDs de usuarios que recibirán el mensaje.
`target_teams`	array of strings (UUID)	Optional	UUIDs de equipos; todos los miembros reciben el mensaje.
`target_channels`	array	Optional	IDs de canales y opciones (estructura definida por la API).
`bot_message_id`	string	Optional	ID personalizado del mensaje para seguimiento o idempotencia. Si se omite, la API devuelve un ID generado.
`buttons`	array	Optional	Botones interactivos.
`image_url`	string	Optional	URL de imagen a adjuntar.
`platform_settings`	object	Optional	Configuración específica de plataforma.
`metadata`	object	Optional	Metadatos personalizados.
`skip_users_on_time_off`	boolean	Optional	Si es true, no enviar a usuarios en descanso.

Petición

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"]
  }'

Response 200 OK

json

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

bot_message_id (string) — El ID enviado en la petición o un ID de tarea generado por el servidor en la forma $db/<uuid>. Úsalo para seguimiento o idempotencia.

Response 403 Forbidden

json

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

API key ausente o inválida.

Info

Al menos uno de target_users, target_channels o target_teams debe proporcionarse.

Tip

Puedes enviar a múltiples usuarios, equipos y canales en una sola petición. El mensaje se entregará a todos los destinos especificados.

Enviar Email

POST /v1/send-email/

Envía un email a los usuarios especificados (por UUID de usuario).

Parámetros del Cuerpo

Name	Type	Required	Description
`users_uuids`	array of strings (UUID)	Required	UUIDs de usuarios que recibirán el email.
`email_subject`	string	Required	Asunto del email.
`email_content`	string	Required	Cuerpo del email (HTML o texto plano).

Petición

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."
  }'

Response 200 OK

json

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

detail (string) — Mensaje de éxito.

Response 400 Bad Request

json

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

Uno o más UUIDs de usuario no encontrados.

Response 403 Forbidden

json

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

API key ausente o inválida.

Abrir Conversación

POST /v1/open-conversation/

Crea una conversación grupal privada (ej. en Slack) con los usuarios especificados.

Parámetros del Cuerpo

Name	Type	Required	Description
`users_uuids`	array of strings (UUID)	Required	UUIDs de usuarios a incluir en la conversación.

Petició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"
    ]
  }'

Response 200 OK

json

{
  "channel": "C0123456789"
}

channel (string) — ID del canal de la plataforma (ej. ID de canal de Slack).

Response 400 Bad Request

json

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

Uno o más UUIDs de usuario no encontrados en la organización.

Response 403 Forbidden

json

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

API key ausente o inválida.

Info

El endpoint Abrir Conversación actualmente solo está disponible para organizaciones que usan Slack como su plataforma.