WhatsApp-ID-Identität von Benutzer*innen

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

Es können Benachrichtigungen von WhatsApp empfangen werden, wenn sich ein*e Benutzer*in, mit dem/der du kommunizierst, möglicherweise geändert hat. Verwende das Edge /v1/contacts, um Identitäten von Benutzer*innen zu verwalten. Weitere Informationen findest du unter Bedeutung von Identitätsänderungen für WhatsApp Business.

Weitere Informationen über Systembenachrichtigungen von WhatsApp findest du unter Eingehende Systemmeldungen – Beispiel: Ein Nutzer hat sich möglicherweise geändert. Die Antwort auf die Systembenachrichtigung wird von deinem Unternehmen verwaltet.

Lesen

Ein GET-Aufruf für diesen Endpunkt ruft den aktuellen Identitäts-Hash für eine*n Benutzer*in ab.

Beispiel

Anfrage

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

Im Erfolgsfall gibt deine Anfrage 200 OK und einen Nachrichtentext mit einem contacts-Objekt zurück. Beispielsweise sieht die vollständige Antwort, einschließlich des contacts-Objekts, möglicherweise wie folgt aus:

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

Zurückgegebene Felder

Das contacts-Antwortobjekt enthält die folgenden Informationen über die Identität des/der Benutzer*in:

Erstellen

Verwende PUT-Aufrufe für diesen Endpunkt, um die aktuelle user_identity_changed-Systembenachrichtigung zu bestätigen.

Bis du einen erfolgreichen identity-API-Aufruf nach dem Eingang einer user_identity_changed-Benachrichtigung vornimmst, werden alle an diesen Benutzer ausgehenden Nachrichten blockiert, wenn die Einstellung show_security_notifications in den Anwendungseinstellungen aktiviert ist.

Beispiel

Anfrage

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

Eine erfolgreiche Antwort ist 200 OK mit dem Nachrichtentext null bzw. {}.

Parameter