Kontakty

Kontakt je jedna osoba ve vašem workspace, identifikovaná svou e-mailovou adresou. Kontakty uchovávají jména a hodnoty vlastních polí, se kterými personalizujete kampaně, a jsou členy seznamů kontaktů, na které se kampaně posílají. Tato stránka vysvětluje, jak do sebe jednotlivé části zapadají a co s kontakty můžete dělat ve webovém rozhraní a přes API.

Kontakty, seznamy kontaktů a odběratelé

Emailit drží lidi a seznamy odděleně. Osoba existuje jednou jako kontakt a každý seznam, ve kterém je, je samostatný záznam odběratele s vlastním stavem přihlášení.

Workspace
├── Contacts ────────────── one per email address
│   ├── email, first_name, last_name, custom_fields
│   └── marketing status (unsubscribed: true | false)
└── Audiences ───────────── named lists, for example "Newsletter"
    └── Subscribers ─────── one per contact on the list
        └── subscribed: true | false

V praxi to znamená:

• Jeden kontakt může být odběratelem mnoha seznamů, v každém se samostatným příznakem Subscribed.
• Když někoho přidáte do seznamu podle e-mailu a kontakt ještě neexistuje, nejdřív se vytvoří.
• Jména a vlastní pole patří kontaktu. Když je upravíte ze seznamu, změní se kontakt, takže se změna projeví všude.

Kdo kampaň dostane

Kampaň se pošle každému kontaktu, který splňuje všechny tři podmínky:

1. Kontakt je odběratelem alespoň jednoho ze seznamů kampaně a má zapnutý příznak Subscribed.
2. Marketingový stav kontaktu je Subscribed.
3. Adresa není na vašem seznamu blokovaných adres.

Kontakt, který je ve více vybraných seznamech, dostane jednu kopii. Úplná pravidla najdete na stránce Vytvoření kampaně.

Marketingový stav

Každý kontakt má také stav Marketing status platný pro celý workspace: Subscribed, nebo Unsubscribed (pole unsubscribed v API). Je to globální odhlášení, které má přednost před příznakem jednotlivých seznamů.

Marketingový stav a přihlášení k seznamům řídí jen kampaně. Neblokují e-maily, které odesíláte přes API nebo SMTP, ani e-maily odeslané automatizacemi. Pokud chcete zastavit veškerou poštu na adresu, přidejte ji mezi blokované adresy. Všechny způsoby odhlášení popisuje stránka Odhlášení.

Stránka Contacts

Otevřete Email Marketing›Contacts a uvidíte všechny kontakty ve workspace, od nejnovějších.

• Sloupce. Email se zobrazuje vždy. Sloupce First name, Last name, Audiences, Created a Updated zapnete nebo vypnete v Display options > Edit columns, nebo vyberte Show full name a jména se sloučí do jednoho sloupce Name. Ve sloupci Audiences je označení každého seznamu zelené, dokud je kontakt k seznamu přihlášený, a červené po odhlášení.
• Vyhledávání hledá v e-mailu, křestním jménu a příjmení.
• Filtrovat můžete podle Email, Name, First name, Last name, Unsubscribed, Created, Updated, Audiences nebo Audience a podle libovolného vlastního pole. Se dvěma a více filtry zvolte, jestli musí odpovídat všechny, nebo stačí kterýkoli.
• Řadit můžete výběrem záhlaví sloupce.
• Import a Export přenášejí kontakty ze souborů a do souborů. Viz Import a export kontaktů.

Výběrem řádku kontakt otevřete. Nabídka řádku obsahuje Edit a Delete.

Přidejte kontakt

Vyberte Add contact, vyplňte Email a volitelně First name, Last name a Audiences. Hodnoty vlastních polí vyplníte po výběru Show custom fields. Každá e-mailová adresa může ve workspace existovat jen jednou, takže přidání existující adresy selže.

Pokud chcete kontakt později změnit, vyberte Edit. Můžete změnit jména a vlastní pole. E-mailovou adresu ve webovém rozhraní změnit nelze. Použijte místo toho pole email v endpointu Úprava kontaktu.

Hromadné akce

Vyberte kontakty zaškrtávacími políčky (políčko v záhlaví vybere celou stránku) a otevřete Actions. Každá akce se najednou použije nejvýše na 100 kontaktů.

Stránka kontaktu

Stránka kontaktu ukazuje vše, co Emailit o jedné osobě ví. Nahoře jsou tlačítka Edit a Delete.

Práce s API

API kontaktů pokrývá vše, co umí seznam a profil kontaktů, kromě importu souborů:

• Kontakty můžete vytvářet, načítat, upravovat, vypisovat a mazat. Všude, kde se očekává ID, můžete místo ID con_ předat e-mailovou adresu kontaktu.
• Při vytvoření kontaktu předejte audiences (pole ID aud_) a kontakt se rovnou přihlásí. Při úpravě audiences nahradí členství kontaktu.
• Na až 100 kontaktů můžete spustit hromadnou akci a až 10 000 jich vyexportovat jako CSV nebo XLSX.

curl https://api.emailit.com/v2/contacts \
  -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", "plan": "pro" },
    "audiences": ["aud_2kq8Vt4xLm7Rz"]
  }'

Vytvoření kontaktu s e-mailem, který už existuje, vrací 409 s existujícím kontaktem v poli existing. API kontaktů potřebuje API klíč s oprávněním Full Access.

Změny kontaktů vyvolávají události contact.created, contact.updated a contact.deleted a změny členství události subscriber.*, které můžete přijímat webhooky.

Další kroky