Kampanjer & innhold
API-utløste kampanjer: send en lagret kampanje
POST /v1/campaigns/:id/trigger sender en lagret kampanje til personer du oppgir, med egne data, eller til lister og segmenter.
POST /v1/campaigns/{id}/trigger sender en lagret kampanje fra ditt eget system: en ordre er lagt, et skjema er fylt ut, en automatisering utløses. I meldingen er dataene {{ trigger.order_id }} (Liquid). Det krever en API-nøkkel med send-rettigheten eller en dashbordbruker som får 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 mottakere per kall; data er høyst 50 nøkler og 8 000 tegn per mottaker. Delt data gjelder alle, og en mottakers egne data vinner.
Mål en målgruppe i stedet
I stedet for recipients oppgir du list_ids og/eller segment_ids (opptil 20 id-er; kontoens egne, ellers list_not_found eller segment_not_found). Målgruppen leses når det sendes, og svaret er 202 { campaign_id, audience }.
Regler
- Den lagrede kampanjen er malen. Hver utløsning kopierer den til en egen kampanje med navnet «<navn> (API trigger)»; den lagrede røres aldri. Bare en
draft-,sent- elleractive-kampanje kan utløses (409campaign_not_triggerable). - Mottakere må allerede være kontakter. Ukjente personer kommer tilbake i
unmatchedog opprettes aldri. Personer som har meldt seg av, utelates og telles iopted_out. - Alt en kampanjeutsendelse håndhever, kjører fortsatt: double opt-in, suppression, frekvenstak og stille timer, kvote, saldo, holdout, A/B, rabattkodepuljer. Verdier HTML-escapes i e-post.
idempotency_key: samme nøkkel på samme lagrede kampanje svarer200 { duplicate: true, campaign_id }og sender ingenting på nytt, selv ved parallelle kall. Sett en hvis kalleren din prøver igjen.- En ny kontos første e-postkampanje venter på at et menneske gjennomgår den, så en utløsning svarer
409 first_campaign_needs_reviewfør noe kopieres. Send kampanjen én gang fra dashbordet først. - En dårlig body, en annen kontos kampanje (404), en skrivebeskyttet nøkkel (403) og ingen nøkkel (401) avvises før noe sendes.
Vil du opprette kontakten først, kall POST /v1/contacts/upsert.
Én plattform. Hver kundeinteraksjon.
Erstatt lappeteppet av meldings-API-er, CDP og automatiseringsverktøy med én engasjementsplattform bygget for skala.
Ingen kredittkort · EU-datalagring · 99,99 % oppetids-SLA