Ihr Agent sendet Statusereignisse an das Gerät des Nutzers, um menschliche Interaktionen zu simulieren. Für Nutzer werden diese Ereignisse als Lesebestätigungen oder Eingabeanzeigen angezeigt, damit sie wissen, dass ihre Nachrichten verarbeitet werden.
Eine vollständige Liste der Formatierungs- und Wertoptionen finden Sie in der Referenz zu phones.agentEvents.
Weitere Informationen zu Webhook-Ereignissen, die Ihr Agent von der RBM-Plattform empfängt, finden Sie unter Ereignisse empfangen.
Der Agent sendet ein READ-Ereignis.
Für Nutzer wird dieses Ereignis als Lesebestätigung für eine bestimmte Nachricht angezeigt. Der Nutzer wird darüber informiert, dass die Nachricht über die RBM-Plattform zugestellt wurde und vom Agent verarbeitet wird.
READ-Ereignisse werden 30 Tage lang gespeichert. Wenn der Nutzer RCS aktiviert hat, aber nicht erreichbar ist, wird das Ereignis in die Warteschlange gestellt. Wenn RCS nicht aktiviert ist, gibt die RCS for Business-Plattform den Fehler NOT_FOUND (HTTP 404) zurück.
Mit dem folgenden Code wird ein READ-Ereignis für eine Nachricht mit einer übereinstimmenden messageId gesendet.
cURL
curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentEvents?eventId=EVENT_ID&agentId=AGENT_ID" \ -H "Content-Type: application/json" \ -H "User-Agent: curl/rcs-business-messaging" \ -H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \ -d "{ 'eventType': 'READ', 'messageId': 'MESSAGE_ID' }"
Node.js
// Reference to RBM API helper const rbmApiHelper = require('@google/rcsbusinessmessaging'); // Send the device an event to indicate that messageId has been read rbmApiHelper.sendReadMessage('+12223334444', messageId);
Java
import com.google.rbm.RbmApiHelper; … // Create an instance of the RBM API helper RbmApiHelper rbmApiHelper = new RbmApiHelper(); // Send the device an event to indicate that messageId has been read rbmApiHelper.sendReadMessage(messageId, "+12223334444");
Python
# Reference to RBM Python client helper and messaging object structure from rcs_business_messaging import rbm_service # Send the device an event to indicate that message_id was read rbm_service.send_read_event('+12223334444', message_id)
C#
using RCSBusinessMessaging; … // Create an instance of the RBM API helper RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation, projectId); // Send the device an event to indicate that messageId has been read rbmApiHelper.SendReadMessage(messageId, "+12223334444");
Der Agent sendet ein IS_TYPING-Ereignis.
Für Nutzer wird dieses Ereignis als Eingabeaufforderung angezeigt und sie wissen, dass Ihr Agent eine Nachricht verfasst. Die Tippanzeige läuft nach kurzer Zeit (ca. 20 Sekunden) ab oder wenn das Gerät des Nutzers eine neue Nachricht von Ihrem Kundenservicemitarbeiter erhält. Ihr Agent kann mehrere IS_TYPING-Ereignisse senden, um den Ablauf-Timer für die Tippanzeige zurückzusetzen.
IS_TYPING-Ereignisse sind kurzlebig und werden nicht in die Warteschlange gestellt.
Mit dem folgenden Code wird ein IS_TYPING-Ereignis gesendet.
cURL
curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentEvents?eventId=EVENT_ID&agentId=AGENT_ID" \ -H "Content-Type: application/json" \ -H "User-Agent: curl/rcs-business-messaging" \ -H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \ -d "{ 'eventType': 'IS_TYPING', }"
Node.js
// Reference to RBM API helper const rbmApiHelper = require('@google/rcsbusinessmessaging'); // Send the device an event to indicate that the agent is typing rbmApiHelper.sendIsTypingMessage('+12223334444', function() { console.log('Typing event sent!'); });
Java
import com.google.rbm.RbmApiHelper; … // Create an instance of the RBM API helper RbmApiHelper rbmApiHelper = new RbmApiHelper(); // Send the device an event to indicate that the agent is typing rbmApiHelper.sendIsTypingMessage("+12223334444");
Python
# Reference to RBM Python client helper and messaging object structure from rcs_business_messaging import rbm_service # Send the device an event to indicate that the agent is typing rbm_service.send_is_typing_event('+12223334444')
C#
using RCSBusinessMessaging; … // Create an instance of the RBM API helper RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation, projectId); // Send the device an event to indicate that the agent is typing rbmApiHelper.SendIsTypingMessage(messageId, "+12223334444");