Antwortende Indikatoren

Antwortindikatoren sind Gesprächssignale, die einer Partei anzeigen, dass die andere Partei eine Nachricht gesehen hat und mit der Vorbereitung einer Antwort begonnen hat. Sie werden in der Regel als drei animierte Punkte angezeigt und verbessern das Gesprächserlebnis, indem sie Unsicherheiten verringern und die Interaktion natürlicher und reaktionsfähiger machen.

Antwortende Indikatoren sind derzeit nur für Whatsapp verfügbar.
Antwortindikatoren können in verschiedenen Formaten dargestellt werden, einschließlich Text und Sprachnotizen. Antworten in Textform werden als Tippindikatoren bezeichnet.

Ein Antwort-Indikator wird automatisch ausgeblendet, wenn eine Antwortnachricht gesendet wird, oder nach 25 Sekunden, je nachdem, was zuerst eintritt. Um eine schlechte Benutzererfahrung zu vermeiden, senden Sie nur dann ein Antwortkennzeichen, wenn Sie eine Antwort erwarten.

Nachdem Sie einen Webhook für eine eingehende Nachricht erhalten haben, können Sie die message_uuid zu:

markieren Sie die Nachricht als readund
der anderen Partei ein Antwortzeichen anzeigen

Dieser Ansatz stellt sicher, dass die Indikatoren für die Beantwortung immer kontextbezogen und zeitnah sind und sich auf eine bestimmte Nachricht in der Konversation beziehen.

Um einen Antwortindikator anzuzeigen, senden Sie eine PATCH-Anforderung an die Nachrichtenressource, die durch message_uuid.

Der Antrag:

aktualisiert den Nachrichtenstatus auf read
enthält eine replying_indicator Objekt, das steuert, ob der Indikator angezeigt wird und welche Art von Antwort vorbereitet wird

Struktur der Anfrage

curl -X PATCH "${GEOSPECIFIC_MESSAGES_API_URL}/${MESSAGES_MESSAGE_ID}" \
  -H "Authorization: Bearer $JWT" \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d '{
    "status": "read",
    "replying_indicator": {
      "show": "true",
      "type": "text"
    }
  }'

Feld	Beschreibung
`status`	Aktualisiert den Status der Nachricht. Muss auf "Lesen" gesetzt werden, um Antwortindikatoren zu aktivieren.
`replying_indicator.show`	Aktiviert oder deaktiviert die Anzeige für die Antwort.
`replying_indicator.type`	Gibt die Art der Antwort an, die vorbereitet wird (z. B. Text).

Geospezifische API-Endpunkte

Die Messages API ist über geospezifische Basis-URLs verfügbar. Sie müssen den Endpunkt verwenden, der der Region entspricht, in der Ihre Anwendung bereitgestellt wird:

Asien-Pazifik (APAC): https://api-ap.vonage.com/v1
Europa (EU): https://api-eu.vonage.com/v1
Vereinigte Staaten (US): https://api-us.vonage.com/v1

In Beispielen, ${GEOSPECIFIC_MESSAGES_API_URL} steht für eine dieser Basis-URLs. Um einen Antwortindikator anzuzeigen, senden Sie eine

PATCH

-Anforderung an die Nachrichtenressource, die durch die Nachrichten-UUID des Kunden identifiziert wird (message_uuid). Diese UUID wird in der Webhook-Nutzlast der eingehenden Nachricht angegeben.

Nachrichten-ID Endpunkt

Die UUID der Nachricht wird an die /messages Ressourcenpfad. Zum Beispiel:

https://api-us.vonage.com/v1/messages/3ca4b881-3e11-46bd-b491-76740a62639a

Diese UUID identifiziert eindeutig die eingehende Nachricht des Kunden, die Sie als gelesen markieren und auf die Sie antworten.

Antwort

Bei Erfolg:

{
  "success": true
}