Skip to main content

GET /v1/whatsapp/contacts/fields

Restituisce i tag e le date personalizzate definiti sull’account. Sono gli unici valori che puoi usare nei campi tags e dates di PUT /v1/whatsapp/contacts/{phone} e di POST /v1/whatsapp/contacts/bulk, e nel filtro tag di GET /v1/whatsapp/contacts. Leggila prima di scrivere i contatti, e ogni volta che un aggiornamento risponde invalid_tags o invalid_dates.
L’API non crea tag né date: si definiscono nel pannello, in MyFlow → Impostazioni, nelle card Tag contatti e Date dei contatti. Così l’elenco resta quello che il team usa davvero in Inbox, Campagne e Automatismi.

Parametri

Nessuno.

Richiesta

Risposta

200 OK
Se sull’account non è stato definito niente, tags e dates sono elenchi vuoti.

Campi

Come si usano

  • Tag: nelle scritture e nel filtro puoi indicare il nome (senza distinzione tra maiuscole e minuscole) o l’id. Il nome è più leggibile; l’id non cambia se qualcuno rinomina il tag nel pannello.
  • Date: in dates la chiave è il nome della data (senza distinzione tra maiuscole e minuscole) o il suo id, e il valore è una data YYYY-MM-DD. Le date personalizzate servono soprattutto agli Automatismi di MyFlow, per esempio un messaggio qualche giorno prima di una scadenza.
  • Il compleanno non è una data personalizzata: ha un campo suo, birthday.
Se un tag viene eliminato dal pannello, i contatti lo perdono. Se viene rinominato, le schede restano collegate e nelle letture compare il nome nuovo.

Errori

Questa rotta non ha errori propri. Gli errori comuni a tutte le rotte sono nell’introduzione.