Identità ID WhatsApp utente

/v1/contacts/{users-whatsapp-id}/identity

È possibile scegliere di ricevere notifiche da WhatsApp quando un utente con cui stai comunicando è potenzialmente cambiato. Usa questo segmento /v1/contacts per gestire le identità degli utenti. Per ulteriori informazioni, consulta Comprensione del cambio di identità per WhatsApp Business.

Per ulteriori informazioni sulla notifica di sistema inviata da WhatsApp, vedi Messaggi di sistema in entrata - Esempio: utente potenzialmente cambiato. La risposta alla notifica di sistema è gestita dalla tua azienda.

Lettura

Una chiamata GET a questo endpoint recupera l'hash di identità più recente di un utente.

Esempio

Richiesta:

GET /v1/contacts/users-whatsapp-id/identity

Risposta:

In caso di azione eseguita correttamente, la richiesta restituisce 200 OK e un corpo del messaggio contenente un oggetto contacts. Ad esempio, la risposta completa, incluso l'oggetto contacts, sarà simile a questa:

{
    "contacts":
    {
        "hash": "UKD6Y/5SqDU=",
        "created_timestamp": 1600132094000,
        "acknowledged": true 
    }
}
  

Campi restituiti

L'oggetto risposta contacts contiene le seguenti informazioni sull'identità dell'utente.

Creazione

Usa chiamate PUT a questo endpoint per confermare la notifica di sistema user_identity_changed più recente.

Finché non effettui una chiamata API identity corretta dopo aver ricevuto una notifica user_identity_changed, tutti i messaggi in uscita per questo utente verranno bloccati se le impostazioni show_security_notifications sono abilitate nelle impostazioni dell'applicazione.

Esempio

Richiesta:

PUT /v1/contacts/users-whatsapp-id/identity
  {
    “hash”: “Rc/eg9RQ0JA=”
  }

Risposta:

Una risposta corretta è 200 OK con un corpo del messaggio null o {}.

Parametri