Správa odběratelů

Odběratel je členství jednoho kontaktu v jednom seznamu kontaktů. Tato stránka ukazuje, jak odběratele přidávat, měnit, odhlašovat, znovu přihlašovat a odebírat a co každá změna udělá s kontaktem, který za nimi stojí.

Než začnete

• Nejdřív vytvořte seznam kontaktů. Viz Seznamy kontaktů.
• Zkontrolujte, kolik místa v seznamu zbývá. Do limitu se počítají všichni odběratelé včetně odhlášených. Viz Limity.
• Pro API použijte API klíč s oprávněním Full Access.

Přidejte odběratele

curl https://api.emailit.com/v2/audiences/aud_5hJ2kL8mNp4Qr/subscribers \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "ada@example.com",
    "first_name": "Ada",
    "last_name": "Lovelace",
    "custom_fields": { "company": "Acme" }
  }'

{
  "object": "subscriber",
  "id": "sub_7Rt2vX9kLm3Qp",
  "audience_id": "aud_5hJ2kL8mNp4Qr",
  "contact_id": "con_2kq8Vt4xLm7Rz",
  "email": "ada@example.com",
  "first_name": "Ada",
  "last_name": "Lovelace",
  "custom_fields": { "company": "Acme" },
  "subscribed": true,
  "subscribed_at": "2026-10-01T09:30:00Z",
  "unsubscribed_at": null,
  "created_at": "2026-10-01T09:30:00Z",
  "updated_at": "2026-10-01T09:30:00Z"
}

Když už je osoba v seznamu

Co se stane při přidání adresy, která už v seznamu je, závisí na jejím aktuálním stavu:

Opětovné přihlášení přes tento endpoint vyvolá události subscriber.updated a subscriber.resubscribed a spustí automatizace Added to audience, stejně jako u nového odběratele.

Upravte odběratele

V tabulce odběratelů seznamu otevřete nabídku řádku a vyberte Edit. Můžete změnit First name, Last name a přepínač Subscribed. E-mailovou adresu tady upravit nelze.

Přes API zavolejte endpoint Úprava odběratele. Odběratele určete jeho ID sub_, nebo e-mailovou adresou a pošlete kterékoli z polí email, first_name, last_name, custom_fields a subscribed:

curl https://api.emailit.com/v2/audiences/Newsletter/subscribers/ada@example.com \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "first_name": "Augusta", "subscribed": false }'

Jména, e-mail a vlastní pole patří kontaktu, ne odběrateli. Když je tady změníte, kontakt se upraví všude, i v ostatních seznamech. Jen subscribed se týká výhradně tohoto seznamu.

Zapněte nebo vypněte Subscribed

Příznak Subscribed rozhoduje, jestli se k osobě dostanou kampaně posílané na tento seznam. Jeho vypnutím odběratel v seznamu zůstane, zaznamená se unsubscribed_at a ostatní seznamy kontaktu zůstanou beze změny. Opětovným zapnutím se nastaví nové subscribed_at a unsubscribed_at se vymaže.

Tyto změny vyvolají událost subscriber.updated. Nezaznamenají odhlášení u žádné kampaně, takže se neobjeví na kartě Unsubscribes kampaně. Když se příjemci odhlásí sami odkazem v kampani, opustí všechny seznamy najednou. Viz Odhlášení.

Odeberte odběratele

Odebrání odběratele smaže členství. Na stránce seznamu vyberte v nabídce řádku Delete, na stránce kontaktu Remove from audience nebo zavolejte endpoint Smazání odběratele.

Když se někdo odhlásí, dejte přednost odhlášení, abyste o tom měli záznam. Odebírejte odběratele, které jste přidali omylem, nebo které už nechcete mít v seznamu. Pokud chcete osobu smazat úplně, smažte kontakt, čímž se odebere ze všech seznamů.

Vypište a najděte odběratele

Na stránce seznamu můžete hledat podle e-mailu nebo jména a filtrovat podle Email, First name, Last name, Subscribed nebo Created.

Přes API vrací Výpis odběratelů všechny odběratele včetně odhlášených. Výpis zúžíte parametrem subscribed=true, nebo subscribed=false, parametr search hledá v e-mailu a jménech a parametry page a limit (nejvýše 100) slouží ke stránkování:

curl "https://api.emailit.com/v2/audiences/aud_5hJ2kL8mNp4Qr/subscribers?subscribed=true&limit=100&page=1" \
  -H "Authorization: Bearer $EMAILIT_API_KEY"

Jednu osobu dohledáte přes Načtení odběratele podle ID sub_, nebo e-mailové adresy.

Související