Connecter Vercel

Sans webhook, PostShip vérifie votre site sur son cycle habituel. Avec, la vérification part dans la seconde qui suit la mise en ligne, avec le commit déployé et la distinction entre production et preview. Deux chemins mènent au même traitement : l'intégration en un clic, et le webhook d'équipe que vous créez vous-même.

En un clic (recommandé)

1. Ouvrez Projet → Intégrations, carte Déploiement, section Vercel.
2. Cliquez sur Connecter Vercel. Vercel vous demande d'autoriser PostShip sur votre compte ou votre équipe, avec les seules permissions Deployments: Read et Projects: Read.
3. Au retour, PostShip cherche le projet Vercel dont le domaine correspond à l'URL de production du projet et le branche seul. Si aucun ne correspond, la carte affiche « Autorisation acceptée » et la question « Quel projet Vercel correspond à celui-ci ? » : choisissez-le et cliquez sur Brancher.
4. La carte affiche désormais Débrancher Vercel ; il n'y a plus rien à copier.

C'est le seul chemin qui fonctionne sur un compte Vercel Hobby : les webhooks d'équipe, ci-dessous, demandent un plan Vercel Pro ou Enterprise. Débrancher détache le projet et oublie l'autorisation côté PostShip si plus aucun projet ne s'en sert ; l'intégration elle-même se retire depuis votre tableau de bord Vercel (Integrations).

Le repli : créer le webhook à la main

Le webhook se crée au niveau de l'équipe Vercel, pas du projet.

1. Sur vercel.com, ouvrez les Settings de votre équipe → Webhooks → Create Webhook. Le lien Ouvrir les webhooks Vercel sur la carte vous y emmène.
2. Cochez Deployment Ready et Deployment Promoted, puis limitez le webhook au projet concerné.
3. Collez L'URL du webhook affichée sur la carte comme endpoint. Elle a la forme https://postship.fr/api/vercel/deploy/<id du projet>.
4. Créez-le : Vercel affiche un secret une seule fois. Copiez-le dans le champ Secret de la carte et cliquez sur Enregistrer.

Ce que PostShip fait de l'événement

• La signature x-vercel-signature (HMAC-SHA1 du corps) est vérifiée en premier ; une signature fausse répond 401 Invalid signature, et rien n'est enregistré.
• payload.target décide : "production" déclenche la vérification complète décrite sur Connecter votre hébergeur. Toute autre valeur (staging, vide) est traitée comme une preview — vérifier une preview par erreur coûte quelques requêtes, l'inverse réécrirait l'état du projet.
• Le commit vient de meta.githubCommitSha, présent seulement sur un déploiement issu de l'intégration Git de Vercel. Sans lui, pas de Check GitHub, et tout le reste tourne.
• Les autres types (deployment.created, error, canceled) répondent skipped: true.

Previews

Avec Activer la vérification des previews, chaque déploiement dont l'hôte est en *.vercel.app est vérifié sur sa propre adresse ; les alertes, si vous les activez, sont préfixées « Preview — ». Une preview reçoit aussi un Check GitHub, sans Ship Score, et une comparaison visuelle avec la dernière capture de production. Voir Previews.

Vérifier que ça marche

La carte affiche « Dernier webhook reçu il y a … » dès qu'une requête correctement signée arrive, quel que soit l'événement. Tant qu'elle indique « Aucun webhook reçu pour l'instant » après un déploiement, c'est l'URL ou le secret. Déployez une fois pour trancher.

Limites et plans

Sur Free, le webhook répond 403 Plan does not include this même correctement signé ; la détection par empreinte reste active.

Dépannage

Pourquoi « Aucun webhook reçu » alors que Vercel montre une livraison réussie ?

Vercel affiche le statut HTTP de la livraison : un 401 y apparaît comme une livraison. Ouvrez la livraison dans Vercel et lisez la réponse. Invalid signature : le secret collé n'est pas celui de ce webhook. Not configured : aucun secret enregistré sur la carte.

Pourquoi la production a été vérifiée alors que je n'ai déployé qu'un autre projet Vercel ?

Un webhook d'équipe qui n'est pas limité à un projet reçoit les déploiements de tous les projets de l'équipe : la mise en production d'un site voisin déclenche alors la vérification de celui-ci. Éditez le webhook côté Vercel et restreignez-le au bon projet. Une preview de branche, elle, est bien traitée comme une preview : son target n'est pas production.

Pourquoi le Check GitHub ne s'affiche pas sur le commit ?

Le déploiement doit venir de l'intégration Git de Vercel pour porter githubCommitSha. Un vercel deploy --prod depuis un terminal n'en a pas. Et GitHub doit être connecté sur le projet.

Le bouton Connecter n'apparaît pas

L'intégration n'est proposée que si PostShip a ses clés Vercel en production. Le webhook manuel reste disponible dans tous les cas.