Saltar al contenido principal

Notificaciones

DocStatic utiliza GitHub Actions para enviar notificaciones de flujo de trabajo. En la carpeta .github/workflows/ se incluyen ejemplos de notificaciones de revisión y traducción. Para habilitarlas, es necesario realizar algunas configuraciones en GitHub. También puedes utilizarlas como punto de partida para desarrollar tus propias notificaciones personalizadas.

Correo electrónico​

Las acciones email-review.yml y email-translate.yml se activan cuando se establecen las etiquetas de revisión o traducción en un archivo Markdown en la rama principal. Para utilizarlas, añada estos secretos a su repositorio:

  • SMTP_SERVER
  • SMTP_PORT
  • SMTP_USERNAME
  • SMTP_PASSWORD
  • NOTIFY_EMAIL_TO
  • NOTIFY_EMAIL_FROM

Puede obtener esta información de su proveedor de correo electrónico. Por ejemplo:

Slack​

Las acciones slack-review.yml y slack-translate.yml utilizan los mismos desencadenantes que las versiones de correo electrónico. Para utilizarlas, añade tu URL de webhook de Slack como un secreto denominado SLACK_WEBHOOK_URL. Para obtener más información, consulta Envío de mensajes mediante webhooks entrantes en la documentación de Slack.

Teams​

Las acciones teams-review.yml y teams-translate.yml funcionan como las versiones de Slack. Microsoft va a dejar de utilizar la aplicación Incoming Webhooks para Teams a partir de diciembre de 2025, pero actualmente no existe un método GitHub disponible públicamente para enviar tarjetas adaptativas a los flujos de trabajo. La solución alternativa es utilizar curl:

- nombre: Enviar notificación de prueba de Teams
  ejecutar: |
    curl --ssl-no-revoke -X POST \
    --location ${{ secrets.MS_TEAMS_HTTP_POST_URL }} \
    --header 'Content-Type: application/json' \
    --data '{ \
      "type": "message", \
      "attachments": [{ \
        "contentType": "application/vnd.microsoft.card.adaptive", \
        "content": { \
          "$schema": "http://adaptivecards.io/schemas/adaptive-card.json", \
          "type": "AdaptiveCard", \
          "version": "1.3", \
          "body": [ { \
            "type": "TextBlock", \
            "text": "This is a test notification from GitHub Actions (Teams).", \
            "wrap": true }]}}]}'
  1. En Teams, ve al canal al que deseas enviar mensajes, haz clic en los tres puntos (…) y selecciona Flujos de trabajo.
  2. Haz clic en Administrar.
  3. Haz clic en Nuevo flujo.
  4. Busca plantillas para webhooks y haz clic en Enviar alertas de webhook a un canal.
  5. (Opcional) Edita el Nombre del flujo.
  6. Inicia sesión y haz clic en Siguiente.
  7. Selecciona un Equipo y un Canal de las listas y haz clic en Crear flujo.
  8. Copia MS_TEAMS_HTTP_POST_URL, guárdalo como secreto en GitHub y haz clic en Hecho.
Consejo

Puedes utilizar la acción de GitHub Probar notificaciones para comprobar tus conexiones.