Webhook entrante (Integraciones)

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

Recibe contactos de plataformas externas (Shopify, WooCommerce, HubSpot, Klaviyo, Pipedrive y otras). En cada evento extraemos el contacto (nombre / teléfono / email), lo creamos o actualizamos en SendApp y lo etiquetamos con la plataforma de origen (p. ej. shopify). No se envía ningún mensaje: llega a esos contactos más tarde con una Campaña (por etiqueta) o vía API.

El payload puede ser cualquier JSON: buscamos recursivamente las claves de teléfono, email y nombre a cualquier profundidad. Respuesta típica: { "status": "ok", "contact": { "id": 12345 } }.

Si no encontramos ni teléfono ni email, respondemos 200 con status: ignored, para que la plataforma de origen mantenga el webhook activo.

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.

Parámetros

3 · 1 obligatorios

token obligatorio

Token de la cuenta, en la ruta de la URL. Determina qué cuenta recibe los contactos.

source opcional

Query string, p. ej. ?source=shopify. Se usa como etiqueta del contacto; en su defecto se usa el User-Agent.

X-Webhook-Secret opcional

Cabecera. La clave dedicada generada en Integraciones → Webhook. Recomendada: sin ella lo único que autentica la llamada es el token de la cuenta, que es público. Si envías una clave incorrecta, la solicitud se rechaza con 401.

¿Necesitas ayuda con la integración? 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());