Gå til indhold
WeZend

Kampagner & indhold

API-udløste kampagner: send en gemt kampagne

POST /v1/campaigns/:id/trigger sender en gemt kampagne til personer, du angiver, med egne data, eller til lister og segmenter.

POST /v1/campaigns/{id}/trigger sender en gemt kampagne fra dit eget system: en ordre er afgivet, en formular er udfyldt, en automatisering udløses. I beskeden er dataene {{ trigger.order_id }} (Liquid). Det kræver en API-nøgle med send-rettigheden eller en dashboard-bruger, der må starte.

{
  "recipients": [
    { "email": "ann@example.com", "data": { "order_id": "1001", "total": "99 EUR" } },
    { "contact_id": "…", "data": { "order_id": "1002" } }
  ],
  "data": { "shop": "Acme" },
  "idempotency_key": "order-1001"
}

Svaret er 202 { campaign_id, accepted, unmatched, opted_out }. Du kan sende 1 til 1.000 modtagere pr. kald; data er højst 50 nøgler og 8.000 tegn pr. modtager. Delte data gælder for alle, og en modtagers egne data vinder.

Ram en målgruppe i stedet

I stedet for recipients angiver du list_ids og/eller segment_ids (op til 20 id'er; kontoens egne, ellers list_not_found eller segment_not_found). Målgruppen læses, når der sendes, og svaret er 202 { campaign_id, audience }.

Regler

  • Den gemte kampagne er skabelonen. Hver udløsning kopierer den til en kampagne for sig med navnet "<navn> (API trigger)"; den gemte røres aldrig. Kun en draft-, sent- eller active-kampagne kan udløses (409 campaign_not_triggerable).
  • Modtagere skal allerede være kontakter. Ukendte personer kommer tilbage i unmatched og oprettes aldrig. Personer, der har meldt sig fra, udelades og tælles i opted_out.
  • Alt, en kampagneafsendelse håndhæver, kører stadig: double opt-in, suppression, frekvensloft og stille timer, kvote, saldo, holdout, A/B, rabatkodepuljer. Værdier HTML-escapes i e-mail.
  • idempotency_key: samme nøgle på samme gemte kampagne svarer 200 { duplicate: true, campaign_id } og sender intet igen, selv ved parallelle kald. Sæt en, hvis din kalder prøver igen.
  • En ny kontos første e-mailkampagne venter på, at et menneske gennemgår den, så en udløsning svarer 409 first_campaign_needs_review, før noget kopieres. Send kampagnen én gang fra dashboardet først.
  • En dårlig body, en anden kontos kampagne (404), en skrivebeskyttet nøgle (403) og ingen nøgle (401) afvises, før noget sendes.

Vil du oprette kontakten først, så kald POST /v1/contacts/upsert.

Én platform. Hver eneste kundeinteraktion.

Erstat dit kludetæppe af messaging-API'er, CDP og automatiseringsværktøjer med én engagement-platform bygget til skala.

Intet kreditkort · EU-datalagring · 99,99 % oppetids-SLA