Contatti

Un contatto è una persona del tuo workspace, identificata dal suo indirizzo email. I contatti contengono i nomi e i valori dei campi personalizzati che usi per personalizzare le campagne, e fanno parte delle liste, cioè gli elenchi a cui vengono inviate le campagne. Questa pagina spiega come si combinano questi elementi e cosa puoi fare con i contatti nel pannello e con l’API.

Contatti, liste e iscritti

Emailit tiene separate persone e liste. Una persona esiste una sola volta come contatto, e ogni lista in cui si trova è un record di iscritto separato con il proprio stato di opt-in.

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

In pratica:

• Un contatto può essere iscritto a molte liste, con un indicatore Subscribed separato in ciascuna.
• Aggiungere qualcuno a una lista tramite email crea prima il contatto, se non esiste ancora.
• Nomi e campi personalizzati appartengono al contatto. Modificarli da una lista cambia il contatto, quindi la modifica compare ovunque.

Chi riceve una campagna

Una campagna viene inviata a ogni contatto che soddisfa tutte e tre le condizioni:

1. Il contatto è iscritto ad almeno una delle liste della campagna, con Subscribed attivo.
2. Lo stato marketing del contatto è Subscribed.
3. L’indirizzo non è nella lista di soppressione.

Un contatto presente in più liste selezionate riceve una sola copia. Per le regole complete, vedi Crea una campagna.

Stato marketing

Ogni contatto ha anche uno stato marketing valido per tutto il workspace, il campo Marketing status: Subscribed o Unsubscribed (il campo unsubscribed nell’API). È un opt-out globale che sta sopra l’indicatore delle singole liste.

Stato marketing e iscrizioni alle liste controllano solo le campagne. Non bloccano le email che invii con l’API o SMTP, né quelle inviate dalle automazioni. Per bloccare tutta la posta verso un indirizzo, aggiungilo alle soppressioni. Disiscrizioni descrive tutti i modi di fare opt-out.

L’elenco Contacts

Apri Email Marketing›Contacts per vedere tutti i contatti del workspace, a partire dai più recenti.

• Colonne. Email è sempre visibile. Attiva o disattiva First name, Last name, Audiences, Created e Updated in Display options > Edit columns, oppure seleziona Show full name per unire nome e cognome in un’unica colonna Name. Nella colonna Audiences, il badge di ogni lista è verde finché il contatto è iscritto e rosso dopo la disiscrizione.
• La ricerca trova corrispondenze su email, nome e cognome.
• Filtra per Email, Name, First name, Last name, Unsubscribed, Created, Updated, Audiences o Audience, e per qualsiasi campo personalizzato. Con due o più filtri, scegli se devono corrispondere tutti o almeno uno.
• Ordina selezionando l’intestazione di una colonna.
• Import ed Export importano ed esportano i contatti come file. Vedi Importa ed esporta i contatti.

Seleziona una riga per aprire il contatto. Il menu della riga contiene Edit e Delete.

Aggiungi un contatto

Seleziona Add contact e compila il campo Email e, se vuoi, First name, Last name e Audiences. Seleziona Show custom fields per inserire i valori dei campi personalizzati. Un indirizzo email può esistere una sola volta per workspace, quindi l’aggiunta di un indirizzo già presente non riesce.

Per modificare un contatto in seguito, seleziona Edit. Puoi cambiare nome, cognome e campi personalizzati. L’indirizzo email non si può cambiare dal pannello: usa invece il campo email di Aggiorna un contatto.

Azioni di massa

Seleziona i contatti con le caselle di spunta (la casella nell’intestazione seleziona l’intera pagina), poi apri Actions. Ogni azione si applica a un massimo di 100 contatti alla volta.

La pagina del contatto

La pagina del contatto mostra tutto ciò che Emailit sa di una persona. In alto trovi Edit e Delete.

Usa l’API

L’API dei contatti copre tutto ciò che fanno l’elenco e il profilo, tranne l’importazione di file:

• Crea, recupera, aggiorna, elenca ed elimina i contatti. Dove è previsto un ID, puoi passare l’indirizzo email del contatto al posto del suo ID con_.
• Passa audiences (un array di ID aud_) quando crei un contatto per iscriverlo subito. Nell’aggiornamento, audiences sostituisce le appartenenze del contatto.
• Esegui un’azione di massa su un massimo di 100 contatti ed esportane fino a 10.000 in CSV o 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"]
  }'

Creare un contatto con un’email già esistente restituisce 409 con il contatto esistente in existing. L’API dei contatti richiede una chiave API con Full Access.

Le modifiche ai contatti generano gli eventi contact.created, contact.updated e contact.deleted, e le modifiche alle appartenenze generano gli eventi subscriber.*, che puoi ricevere con i webhook.

Passaggi successivi