Skip to main content

GET /v1/whatsapp/contacts/{phone}

Restituisce un contatto: gli stessi campi dell’elenco, più il compleanno e le date personalizzate della scheda. Usala quando il gestionale apre la scheda di un cliente e vuole sapere che cosa sa MyFlow di quel numero.

Parametri

Il numero viene letto come negli altri campi telefono dell’API: con il prefisso internazionale (consigliato), oppure un numero italiano senza prefisso (un cellulare che inizia per 3, un fisso che inizia per 0), a cui viene aggiunto il 39.

Richiesta

Risposta

200 OK

Campi del contatto

I campi da phone a numbers sono descritti nell’elenco contatti. In più:
Una persona che ha scritto ma non ha una scheda risponde comunque 200, con has_card: false. In quel caso birthday e dates non ci sono proprio, perché sono campi della scheda. Per darle una scheda usa PUT /v1/whatsapp/contacts/{phone}.

Errori

400 - invalid_phone

Il numero non è riconoscibile. Usa il formato internazionale, per esempio +393331234567.

404 - contact_not_found

Nessun contatto con questo numero: non ha mai scritto ai tuoi numeri WhatsApp e non ha una scheda. Puoi crearla con PUT /v1/whatsapp/contacts/{phone}. Gli errori comuni a tutte le rotte sono nell’introduzione.