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- elleractive-kampagne kan udløses (409campaign_not_triggerable). - Modtagere skal allerede være kontakter. Ukendte personer kommer tilbage i
unmatchedog oprettes aldrig. Personer, der har meldt sig fra, udelades og tælles iopted_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 svarer200 { 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