Eingehender Webhook (Integrationen)

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

Empfangen Sie Kontakte von externen Plattformen (Shopify, WooCommerce, HubSpot, Klaviyo, Pipedrive und anderen). Bei jedem Ereignis extrahieren wir den Kontakt (Name / Telefon / E-Mail), erstellen oder aktualisieren ihn in SendApp und versehen ihn mit einem Tag der Herkunftsplattform (z. B. shopify). Es wird keine Nachricht gesendet: Erreichen Sie diese Kontakte anschließend mit einer Kampagne (per Tag) oder über die API.

Der Payload kann beliebiges JSON sein: Wir suchen rekursiv in beliebiger Tiefe nach den Schlüsseln für Telefon, E-Mail und Name. Typische Antwort: { "status": "ok", "contact": { "id": 12345 } }.

Wenn wir weder Telefon noch E-Mail finden, antworten wir mit 200 und status: ignored, damit die Herkunftsplattform den Webhook aktiv hält.

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.

Parameter

3 · 1 Pflichtfelder

token erforderlich

Konto-Token, im URL-Pfad. Bestimmt, welches Konto die Kontakte erhält.

source optional

Query-String, z. B. ?source=shopify. Wird als Kontakt-Tag verwendet; fehlt er, wird der User-Agent verwendet.

X-Webhook-Secret optional

Header. Der eigene Schlüssel, erzeugt unter Integrationen → Webhook. Empfohlen: Ohne ihn authentifiziert nur das Konto-Token den Aufruf, und das ist öffentlich. Sendest du einen falschen Schlüssel, wird die Anfrage mit 401 abgelehnt.

Brauchen Sie Hilfe bei der Integration? 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());