Recette : GitHub Actions vers Synkro

Cette recette publie un message dans un canal de Synkro à la fin d'une étape de GitHub Actions (déploiement, tests, publication). Elle a été jouée sur une vraie charge : le message est arrivé dans le canal.

La chaîne

Outil : GitHub Actions.
Étape : slackapi/slack-github-action@v2.1.0, en mode incoming-webhook.
Destination : le webhook entrant de Synkro, au format Slack, c'est-à-dire son adresse suivie de /slack.

Mise en place

Dans Administration › Intégrations, crée un webhook entrant pour le canal voulu et copie son adresse (affichée une seule fois).
Dans les secrets du dépôt GitHub, crée SYNKRO_WEBHOOK_URL avec cette adresse suivie de /slack.
Ajoute l'étape à ton workflow :

- name: Prévenir Synkro
  uses: slackapi/slack-github-action@v2.1.0
  with:
    webhook: ${{ secrets.SYNKRO_WEBHOOK_URL }}
    webhook-type: incoming-webhook
    payload: |
      text: "Déploiement de *api-client* terminé sur la branche main"

Ce que Synkro reçoit

POST https://integrations.mysynkro.fr/hooks/in/syk_whk_…/slack
Content-Type: application/json

{ "text": "Déploiement de *api-client* terminé sur la branche main" }

Synkro répond 200 avec le corps ok, et le message apparaît dans le canal.

Ce qui est converti

Synkro convertit les champs text, attachments et blocks du format Slack en Markdown (gras, italique, liens, code) et ignore le reste (username, icon_url, channel…). Le format Slack ne crée jamais de mention, et @channel et @here restent du texte, sans notification.

Limites

Les limites des webhooks entrants s'appliquent : corps de 100 Kio au plus, 10 messages d'un coup puis 1 par seconde par webhook, 300 messages par minute par organisation.
Le webhook est lié à un seul canal, jamais un canal confidentiel.
Garde l'adresse du webhook comme un mot de passe : mets-la dans un secret de l'outil, jamais dans un dépôt ni dans une page publique.

Retour à la page Développeurs : webhooks entrants, formats, signature et limites.

Dernière mise à jour : 23 octobre 2026.