Recette d'intégration

WhatsApp + Zapier / Make : connectez-le dès aujourd'hui avec la REST API

Fonctionne dès aujourd'hui via HTTP, sans application nativeDernière vérification : août 2026

Spun ne dispose pas encore d'une application Zapier ou Make publiée et installable en un clic. Ce dont il dispose, c'est d'une REST API conçue précisément pour cela : envoyer des messages WhatsApp, créer ou mettre à jour des contacts, appliquer des étiquettes et vérifier si un numéro a WhatsApp, ainsi que des webhooks sortants pour les événements en temps réel. Les deux se branchent directement sur l'étape « Webhooks by Zapier » de Zapier ou sur le module HTTP de Make, et de la même façon sur le nœud HTTP Request de n8n.

Cette recette est la voie honnête, qui fonctionne dès aujourd'hui. Si vous préférez une application native répertoriée à une étape HTTP générique, consultez les notes de faisabilité en bas de page pour savoir ce qu'il faudrait pour la lancer.

1. Créez une clé API

  1. 1

    Ouvrez les clés API

    Dans votre boîte de réception Spun : « Paramètres », puis « Webhooks », puis « Gérer les clés API », puis « Nouvelle clé ».

  2. 2

    Nommez-la et choisissez les portées

    Donnez-lui un nom comme « Zapier Production ». N'activez que les portées dont vous avez réellement besoin : envoyer des messages, gérer les contacts, lire les contacts, gérer les étiquettes, lire les étiquettes ou vérifier les numéros de téléphone.

  3. 3

    Copiez-la une seule fois

    La clé (qui commence par wap_) n'est affichée qu'une fois. Conservez-la dans le coffre d'identifiants de votre plateforme d'automatisation, jamais dans une étape de workflow ni dans un document partagé.

2. Appelez Spun depuis un Zap, un scénario ou un workflow

Chaque action utilise la même URL de base avec le même en-tête. Dans Zapier, utilisez « Webhooks by Zapier » > Custom Request ; dans Make, un module HTTP réglé sur « Make a request » ; dans n8n, un nœud HTTP Request avec Header Auth.

  • check-phone : vérifiez qu'un numéro a WhatsApp avant d'envoyer (jusqu'à 20 numéros par appel).
  • create-contact / update-contact : gardez la fiche WhatsApp d'un prospect synchronisée depuis n'importe quel formulaire ou CRM.
  • apply-label / remove-label : étiquetez une conversation à partir d'un déclencheur externe, par exemple appliquez l'étiquette « Nouveau prospect » dès qu'un formulaire est envoyé.
Envoyer un message WhatsApp (POST /api/integrations/send-message)
POST https://api.spun.com/api/integrations/send-message
Authorization: Bearer wap_YOUR_KEY
Content-Type: application/json

{
  "to": "15551234567",
  "text": "Hello! Thanks for contacting us."
}

Si le canal WhatsApp est brièvement hors ligne, send-message renvoie quand même un succès avec un indicateur de mise en file d'attente au lieu d'échouer : le message part automatiquement dès que le canal se reconnecte.

3. Recevez les événements WhatsApp dans Zapier ou Make

  1. 1

    Créez d'abord l'étape de réception

    Dans Zapier, commencez un Zap avec « Webhooks by Zapier » > Catch Hook, et copiez l'URL fournie. Dans Make, ajoutez un module déclencheur Custom Webhook et copiez son URL.

  2. 2

    Collez-la dans Spun

    « Paramètres », puis « Webhooks », puis « Ajouter un webhook ». Collez l'URL et choisissez les événements qui doivent le déclencher.

  3. 3

    Déclenchez un événement de test

    Envoyez-vous un message WhatsApp, puis cliquez sur « Test trigger » (Zapier) ou exécutez le scénario une fois (Make) pour récupérer un vrai exemple de contenu.

Ce que Spun envoie sur message.inbound
{
  "event_id": "550e8400-e29b-41d4-a716-446655440000",
  "event": "message.inbound",
  "timestamp": "2026-08-18T10:30:00.000Z",
  "org_id": "123",
  "data": {
    "message_id": "[email protected]_ABC123",
    "chat_id": "[email protected]",
    "from": "15551234567",
    "type": "text",
    "text": "Hello!"
  }
}

Événements disponibles : message entrant ou sortant, contact créé, mis à jour ou supprimé, étiquette attribuée, flux de conversation terminé, message en file d'attente traité, prospect qualifié, conversation archivée et appel terminé.

Ce que vous devez savoir avant de construire dessus

  • Il ne s'agit pas d'une application Zapier ou Make répertoriée et consultable. Il n'existe pas aujourd'hui d'écran OAuth « Connect your Spun account » dans Zapier ou Make : l'authentification repose sur une clé API statique que vous collez vous-même dans les en-têtes de l'étape HTTP.
  • Les abonnements webhook (le côté « réception des événements ») ne peuvent pour l'instant être créés que depuis l'interface des Paramètres de Spun, pas depuis Zapier, donc un déclencheur de type REST Hook qui s'abonne tout seul n'est pas encore disponible.
  • La limite est de 60 requêtes par minute et par clé API. Regroupez les vérifications de numéros (jusqu'à 20 par appel) au lieu de les enchaîner une par une lorsque c'est possible.

À lire aussi : WhatsApp + Google Sheets (entièrement natif, sans clé API) · WhatsApp + HubSpot CRM

Questions fréquentes

Existe-t-il une application Spun officielle dans l'annuaire Zapier ou Make ?

Pas encore. La REST API et les webhooks sortants qu'elle utiliserait sont déjà en service, donc les mêmes actions et déclencheurs fonctionnent dès aujourd'hui via l'étape HTTP/Webhooks générique de Zapier, Make et n8n.

Que puis-je faire avec l'API aujourd'hui ?

Envoyer un message texte WhatsApp, vérifier si un numéro a WhatsApp, créer ou mettre à jour un contact, et appliquer ou retirer une étiquette sur une conversation, ainsi que recevoir des événements en temps réel (nouveau message, nouveau contact, étiquette appliquée, flux de conversation terminé, prospect qualifié, conversation archivée, appel terminé) sous forme de webhooks sortants.

Comment m'authentifier ?

Créez une clé API dans « Paramètres » > « Webhooks » > « Gérer les clés API », ne choisissez que les portées nécessaires, et envoyez-la comme jeton Bearer dans l'en-tête Authorization. Il n'existe pas de flux OAuth pour cette API aujourd'hui.

Zapier peut-il s'abonner automatiquement à mes événements Spun, comme avec une application REST Hook native ?

Pas encore. Vous collez l'URL du catch hook Zapier ou Make dans l'écran « Paramètres » > « Webhooks » de Spun et vous y choisissez les événements ; Zapier ne peut pas créer cet abonnement à votre place.

Quelles sont les limites de requêtes ?

60 requêtes par minute et par clé API. L'endpoint check-phone accepte jusqu'à 20 numéros en un seul appel, ce qui est le moyen le plus simple de rester largement sous la limite pour les vérifications en masse.

Que se passe-t-il si j'envoie un message alors que le canal WhatsApp est déconnecté ?

L'API renvoie quand même un succès avec un indicateur de mise en file d'attente au lieu d'échouer. Le message part automatiquement dès que le canal se reconnecte, vous n'avez donc pas besoin de construire votre propre logique de nouvelle tentative pour ce cas.

Obtenez une clé API et commencez à construire

L'accès à l'API est disponible avec les formules WhatsApp de Spun, aux côtés de la boîte de réception d'équipe partagée, des réponses par IA et des intégrations natives Google Sheets et HubSpot. Prix fixe à partir de €45 par mois, essai gratuit.

Commencez gratuitement : 7 jours avec tout inclus

Voir toutes les intégrations