Webhook entrant (Intégrations)

POST https://app.sendapp.ai/api/integrations/webhook/{token}

Recevez des contacts depuis des plateformes externes (Shopify, WooCommerce, HubSpot, Klaviyo, Pipedrive et autres). À chaque événement, nous extrayons le contact (nom / téléphone / e-mail), le créons ou le mettons à jour dans SendApp et le taguons avec la plateforme d'origine (ex. shopify). Aucun message n'est envoyé : atteignez ensuite ces contacts avec une Campagne (par tag) ou via l'API.

Le payload peut être n'importe quel JSON : nous recherchons récursivement les clés de téléphone, e-mail et nom à n'importe quelle profondeur. Réponse typique : { "status": "ok", "contact": { "id": 12345 } }.

Si nous ne trouvons ni téléphone ni e-mail, nous répondons 200 avec status: ignored, afin que la plateforme d'origine garde le webhook actif.

Consigliato: proteggi il webhook con una chiave. Il token dell'account compare nel codice del widget sul tuo sito, quindi è pubblico. Genera una chiave dedicata da Integrazioni → Webhook e inviala nell'header X-Webhook-Secret: da quel momento solo chi la conosce può inviare contatti al tuo account. La chiave è mostrata una sola volta, puoi rigenerarla quando vuoi (la precedente smette subito di funzionare) e le integrazioni che non la usano continuano a funzionare finché non decidi di renderla obbligatoria.

Paramètres

3 · 1 obligatoires

token obligatoire

Token du compte, dans le chemin de l'URL. Détermine quel compte reçoit les contacts.

source facultatif

Chaîne de requête, ex. ?source=shopify. Utilisée comme tag du contact ; à défaut, le User-Agent est utilisé.

X-Webhook-Secret facultatif

En-tête. La clé dédiée générée dans Intégrations → Webhook. Recommandée : sans elle, la seule chose qui authentifie l'appel est le token du compte, qui est public. Si vous envoyez une clé erronée, la requête est refusée avec 401.

Besoin d'aide pour l'intégration ? info@sendapp.live

curl -X POST 'https://app.sendapp.ai/api/integrations/webhook/YOUR_ACCOUNT_TOKEN?source=shopify' \ -H 'Content-Type: application/json' \ -H 'X-Webhook-Secret: YOUR_WEBHOOK_SECRET' \ -d '{ "email": "jon@example.com", "customer": { "first_name": "Jon", "last_name": "Snow", "phone": "+391234567890" } }'

<?php $ch = curl_init('https://app.sendapp.ai/api/integrations/webhook/YOUR_ACCOUNT_TOKEN?source=shopify'); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_POST => true, CURLOPT_HTTPHEADER => ['Content-Type: application/json'], CURLOPT_POSTFIELDS => json_encode([ 'email' => 'jon@example.com', 'customer' => ['first_name' => 'Jon', 'last_name' => 'Snow', 'phone' => '+391234567890'], ]), ]); echo curl_exec($ch); curl_close($ch);

const res = await fetch('https://app.sendapp.ai/api/integrations/webhook/YOUR_ACCOUNT_TOKEN?source=shopify', { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ email: 'jon@example.com', customer: { first_name: 'Jon', last_name: 'Snow', phone: '+391234567890' } }) }); console.log(await res.json());