Integrationer & inkommande källor

CDP:n är bara så bra som det som flödar in i den. Integrationsmodulen sköter rören.

Skapa en integration

Inställningar → Integrationer → Ny, eller:

curl -X POST https://api.wezend.com/v1/integrations \
  -H "X-API-Key: $WEZEND_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "type": "shopify", "name": "Huvudbutik", "config": { "shop_domain": "acme.myshopify.com", "access_token": "shpat_…" } }'

En integration definierar vad som ansluts (CRM, butik, eget system), vilka händelser som flödar, och hur kontakter mappas till profiler. Autentiseringsuppgifter är krypterade i vila.

Shopify: appen i stället för ett token

Att klistra in ett access token fungerar fortfarande, och för en privat app är det kortaste vägen. För en vanlig butik är Shopify-appen färre rörliga delar: skicka handlaren till /v1/integrations/shopify/install?shop=acme.myshopify.com&customer_id=<ditt konto-id>, de godkänner på Shopifys egen OAuth-skärm, och callbacken byter koden mot ett token och registrerar webhookarna — så ordrar, kunder och produkter börjar flöda utan att någon kopierar en hemlighet mellan två dashboards. Scopen som begärs är read_orders, write_orders, read_customers, read_products och write_script_tags; GET /v1/integrations/shopify/webhooks/:integrationId listar vad som registrerades, avgränsat till ditt eget konto.

WooCommerce kommer från butikens sida i stället: peka dess webhookar mot POST /v1/integrations/woocommerce/webhook. Båda mottagarna verifierar butikens egen signatur, så ingen av dem behöver en API-nyckel.

Importera en befintlig målgrupp

POST /v1/integrations/:id/import-audience startar ett bakgrundsjobb som hämtar det anslutna systemets kontakter (med samtyckesstatus där källan tillhandahåller den), avdubblerar mot befintliga profiler och rapporterar framsteg — polla GET /v1/integrations/import-jobs/:jobId eller följ förloppsindikatorn i instrumentpanelen. Stora målgrupper importeras utan att blockera något annat.

Testa kopplingen

Innan du litar på en integration, klicka Skicka testhändelse (POST /v1/integrations/:id/test). En syntetisk händelse kör hela pipelinen och visar dig exakt vad som anlände och hur det mappades — felsökning med ficklampa i stället för gissning i mörkret.

Egna system: händelseströmmen

Allt som kan skicka en HTTP-förfrågan är en integration. Strömma beteendehändelser från din backend eller ditt site till POST /v1/events (se Spåra händelser), och exponera den inkommande webhooken för att ta emot svar i dina egna verktyg. Mellan de två och reverse-ETL-aktiveringen ut till annonsplattformar sitter WeZend mitt i stacken snarare än i slutet av den.