Contatti e Liste di Contatti

I contatti sono la tua rubrica. Le liste di contatti raggruppano i contatti in segmenti con nome che puoi usare come target per le campagne.

Gestione contatti

Crea un contatto

POST /contacts

Fornisci il nome del contatto, il numero di telefono, l'email e qualsiasi campo personalizzato.

Cerca e filtra

GET /contacts

Filtra i contatti per nome, numero di telefono, email, genere, validità o supporto canale di comunicazione. I risultati sono paginati.

Aggiorna ed elimina

• PUT /contacts/{id} -- Aggiorna i dettagli di un contatto.
• DELETE /contacts -- Elimina uno o più contatti per ID.

Importazione massiva

L'API supporta due formati di importazione:

Caricamento CSV / Excel

POST /contacts/upload

Carica un file (CSV, Excel) e analizzalo. L'API restituisce le righe analizzate così puoi mappare le colonne ai campi del contatto prima di confermare l'importazione.

Dopo aver revisionato la mappatura, conferma l'importazione con POST /contacts/mapped/file.

Caricamento VCard

POST /contacts/upload/vcard

Carica un file .vcf. I contatti VCard vengono analizzati automaticamente con la mappatura standard dei campi. Conferma con POST /contacts/mapped/vcard.

Liste di contatti

Crea una lista

POST /contacts/list

Dai un nome alla tua lista e opzionalmente una descrizione.

Aggiungi contatti a una lista

POST /contacts/list/contacts

Associa uno o più contatti a una o più liste in un'unica richiesta.

Rimuovi contatti da una lista

DELETE /contacts/list/contacts

Rimuovi contatti specifici da liste specifiche senza eliminare i contatti stessi.

Sfoglia i membri della lista

GET /contacts/list/{listId}/contacts

Lista paginata di tutti i contatti appartenenti a una lista specifica.

Usare le liste nelle campagne

Quando crei una campagna, specifichi una lista di contatti come pubblico target. La campagna invierà il messaggio a ogni contatto nella lista.

Ecco perché organizzare i contatti in liste ben definite è importante: ti permette di mirare il pubblico giusto per ogni campagna.

Esportazione contatti

Per grandi set di dati, usa il workflow di esportazione asincrona:

POST /exports/contacts

Consulta la guida Esportazioni per il workflow completo di esportazione.

Riferimento rapido

Azione	Endpoint
Elenco contatti	GET /contacts
Crea contatto	POST /contacts
Dettaglio contatto	GET /contacts/{id}
Aggiorna contatto	PUT /contacts/{id}
Elimina contatti	DELETE /contacts
Elenco liste	GET /contacts/list
Crea lista	POST /contacts/list
Aggiungi alla lista	POST /contacts/list/contacts
Rimuovi dalla lista	DELETE /contacts/list/contacts
Carica CSV	POST /contacts/upload
Carica VCard	POST /contacts/upload/vcard

Consulta il Riferimento API Contatti e il Riferimento API Liste Contatti per tutti i dettagli.