Hopp til innhold
WeZend

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- eller active-kampanje kan utløses (409 campaign_not_triggerable).
  • Mottakere må allerede være kontakter. Ukjente personer kommer tilbake i unmatched og opprettes aldri. Personer som har meldt seg av, utelates og telles i opted_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 svarer 200 { 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_review fø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