Einen Channel-Prozessor einrichten - Amazon Chime SDK

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Einen Channel-Prozessor einrichten

Um mit der Verwendung von Kanalflüssen zu beginnen, erstellen Sie zunächst eine Prozessor-Lambda-Funktion, die die Vorverarbeitung für Ihren Anwendungsfall übernimmt. Sie können beispielsweise Nachrichteninhalte oder Metadaten aktualisieren, Nachrichten ablehnen und deren Versand verhindern oder die ursprüngliche Nachricht durchlassen.

Voraussetzungen

  • Die Lambda-Funktion muss sich im selben AWS Konto und in denselben AWS Regionen wie die AppInstance befinden.

Erteilen von Aufrufrechten

Sie müssen dem Amazon Chime SDK-Messaging-Service die Erlaubnis erteilen, Ihre Lambda-Ressource aufzurufen. Weitere Informationen zu Berechtigungen finden Sie unter Verwenden ressourcenbasierter Richtlinien für. AWS Lambda Beispielsweise:

Schulleiter: „messaging.chime.amazonaws.com“

Aktion: Lambda: InvokeFunction

Effekt: Erlauben

AWSSourceAccount: Ihr AWS AccountId.

AWSSourceArn: "arn:aws:chime:region:AWS AccountId: appInstance/"

Anmerkung

Sie können eine bestimmte App-Instance-ID angeben, um Ihren Prozessor aufzurufen, oder einen Platzhalter verwenden, damit alle Amazon Chime SDK-App-Instances in einem Konto Ihren Prozessor aufrufen können.

Erteilen von Rückrufberechtigungen

Sie müssen auch den Lambda-Funktionen Ihres Prozessors erlauben, die ChannelFlowCallback API aufzurufen. Informationen dazu finden Sie im AWS Lambda Entwicklerhandbuch unter Rolle AWS Lambda ausführen.

Sie können der Ausführungsrolle Ihrer Lambda-Funktion eine Inline-Richtlinie hinzufügen. In diesem Beispiel kann der Prozessor die aufrufen. ChannelFlowCallback API

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "chime:ChannelFlowCallback"
            ],
            "Resource": [
                "arn:aws:chime:Region:AwsAccountId:appInstance/*"
            ]
        }
    ]
}
Anmerkung

Folgen Sie den Best Practices für Lambda-Funktionen. Weitere Informationen finden Sie in den folgenden Themen:

Aufrufen von Prozessor-Lambda-Funktionen

Wenn ein Benutzer eine Nachricht sendet, ruft die folgende Eingabeanforderung die Lambda-Funktion des Prozessors auf.

{
    "EventType": "string"
    "CallbackId": "string"
    "ChannelMessage": {
        "MessageId": "string",
        "ChannelArn": "string",
        "Content": "string",
        "Metadata": "string",
        "Sender":{
            "Arn": "string", 
            "Name": "string"
        },
        "Persistence": "string",
        "LastEditedTimestamp": "string", 
        "Type": "string",
        "CreatedTimestamp": "string", 
    }
}
EventType

Das Ereignis wird an den Prozessor gesendet. Der Wert ist eine CHANNEL_MESSAGE_EVENT Konstante.

CallbackId

Das Token, das beim Aufrufen der ChannelFlowCallback API vom Prozessor verwendet wurde.

ChannelMessage

ChannelArnDer ARN des Kanals

Inhalt Inhalt der Nachricht, die verarbeitet werden soll

CreatedTimestampDer Zeitpunkt, zu dem die Nachricht erstellt wurde

LastEditedTimestampDer Zeitpunkt, zu dem eine Nachricht bearbeitet wurde

MessageIdDie Nachrichten-ID

Metadaten Zu verarbeitende Nachrichtenmetadaten

Persistence Boolescher Wert, der steuert, ob die Nachricht im Backend persistent gespeichert wird. Zulässige Werte: PERSISTENT | NON_PERSISTENT

Absender Der Absender der Nachricht. Typ: ein identityObjekt.

Geben Sie den Nachrichtentyp ein. ChannelFlowunterstützt nur die STANDARD Nachrichtentypen. Gültiger Wert: STANDARD

Die Prozessorfunktion bestimmt für jede Nachricht Folgendes.

  • Ob der Nachrichteninhalt, die Metadaten oder beides aktualisiert werden sollen

  • Ob eine Nachricht abgelehnt werden soll

  • Ob eine Nachricht unverändert bleiben soll

Wenn die Verarbeitung abgeschlossen ist, sendet die Lambda-Funktion des Prozessors das Ergebnis zurück an den Amazon Chime SDK Messaging-Service, sodass die Nachricht an alle Empfänger gesendet werden kann. Der Nachrichtenstatus wird markiert, PENDING bis die Lambda-Funktion des Prozessors die Ergebnisse zurücksendet. Die Lambda-Funktion des Prozessors hat 48 Stunden Zeit, um die Ergebnisse zurückzusenden. Danach können wir die Nachrichtenzustellung nicht garantieren, und die ChannelFlowCallbackAPI gibt eine Forbidden Exception-Fehlermeldung aus. Rufen Sie die API auf, um die Ergebnisse zurückzusenden. ChannelFlowCallback