View a markdown version of this page

Usa il payload Amazon SNS dopo aver abilitato lo streaming dei messaggi in Connect Customer - Cliente Amazon Connect
Attributi dei messaggi nel payloadEsempio di payload di SNS

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Usa il payload Amazon SNS dopo aver abilitato lo streaming dei messaggi in Connect Customer

Dopo aver abilitato correttamente lo streaming dei messaggi, potrebbe essere necessario filtrare un messaggio in modo che venga inviato al partecipante previsto: l'agente, il cliente o tutti.

Per filtrare in base al partecipante, leggi l'attributo specifico delle intestazioni SNS, MessageVisibility, per stabilire se il messaggio è destinato solo al cliente, solo all'agente o a tutti.

  • Invio solo al cliente: per tutto il codice rivolto al cliente, i client devono filtrare i messaggi destinati a quest'ultimo e creare la seguente logica per inoltrarglieli.

    if ( ( MessageVisibility == CUSTOMER || MessageVisibility == ALL)  && ParticipantRole != CUSTOMER )

  • Invio solo all'agente:

    if ( ( MessageVisibility == AGENT || MessageVisibility == ALL)  && ParticipantRole != AGENT )

Puoi anche utilizzare la funzionalità di filtraggio di Amazon SNS creando politiche di filtraggio degli abbonamenti personalizzate. In questo modo, la logica di filtro dei messaggi viene trasferita dall'abbonato dell'argomento SNS al servizio SNS stesso.

Attributi dei messaggi nel payload

Di seguito è riportata una descrizione di ogni attributo dei messaggi nel payload di Amazon SNS:

  • InitialContactId: l'ID del contatto iniziale della chat.

  • ContactId: l'ID del contatto attuale della chat. InitialContactId e ContactId possono essere diversi se è presente un nuovo agente nella chat o nel flusso di contatti da una coda all'altra.

  • ParticipantRole: il partecipante che ha inviato il messaggio.

  • InstanceId: ID dell'istanza Connect Customer.

  • AccountId: L'ID AWS dell'account.

  • Type: valori possibili: EVENT, MESSAGE.

  • ContentType: valori possibili: application/vnd.amazonaws.connect.event.typing, application/vnd.amazonaws.connect.event.participant.joined, application/vnd.amazonaws.connect.event.participant.left, application/vnd.amazonaws.connect.event.transfer.succeeded, application/vnd.amazonaws.connect.event.transfer.failed, application/vnd.amazonaws.connect.message.interactive, application/vnd.amazonaws.connect.event.chat.ended e altri.

  • MessageVisibility: valori possibili: AGENT, CUSTOMER, ALL.

Esempio di payload di SNS

{
  "Type" : "Notification",
  "MessageId" : "ccccccccc-cccc-cccc-cccc-ccccccccccccc",
  "TopicArn" : "arn:aws:sns:us-west-2:009969138378:connector-svc-test",
  "Message" :  "{\"AbsoluteTime\":\"2021-09-08T13:28:24.656Z\",\"Content\":\"help\",\"ContentType\":\"text/plain\",\"Id\":\"333333333-be0d-4a44-889d-d2a86fc06f0c\",\"Type\":\"MESSAGE\",\"ParticipantId\":\"bbbbbbbb-c562-4d95-b76c-dcbca8b4b5f7\",\"DisplayName\":\"Jane\",\"ParticipantRole\":\"CUSTOMER\",\"InitialContactId\":\"33333333-abc5-46db-9ad5-d772559ab556\",\"ContactId\":\"33333333-abc5-46db-9ad5-d772559ab556\"}",
  "Timestamp" : "2021-09-08T13:28:24.860Z",
  "SignatureVersion" : "1",
  "Signature" : "examplegggggg/1tEBYdiVDgJgBoJUniUFcArLFGfg5JCvpOr/v6LPCHiD7A0BWy8+ZOnGTmOjBMn80U9jSzYhKbHDbQHaNYTo9sRyQA31JtHHiIseQeMfTDpcaAXqfs8hdIXq4XZaJYqDFqosfbvh56VPh5QgmeHTltTc7eOZBUwnt/177eOTLTt2yB0ItMV3NAYuE1Tdxya1lLYZQUIMxETTVcRAZkDIu8TbRZC9a00q2RQVjXhDaU3k+tL+kk85syW/2ryjjkDYoUb+dyRGkqMy4aKA22UpfidOtdAZ/GGtXaXSKBqazZTEUuSEzt0duLtFntQiYJanU05gtDig==",
  "SigningCertURL" : "https://sns.us-west-2.amazonaws.com/SimpleNotificationService-11111111111111111111111111111111.pem",
  "UnsubscribeURL" : "https://sns.us-west-2.amazonaws.com/?Action=Unsubscribe&SubscriptionArn=arn:aws:sns:us-west-2:000000000000:connector-svc-test:22222222-aaaa-bbbb-cccc-333333333333",
  "MessageAttributes" : {
    "InitialContactId" : {"Type":"String","Value":"33333333-abc5-46db-9ad5-d772559ab556"},
    "MessageVisibility" : {"Type":"String","Value":"ALL"},
    "Type" : {"Type":"String","Value":"MESSAGE"},
    "AccountId" : {"Type":"String","Value":"999999999999"},
    "ContentType" : {"Type":"String","Value":"text/plain"},
    "InstanceId" : {"Type":"String","Value":"dddddddd-b64e-40c5-921b-109fd92499ae"},
    "ContactId" : {"Type":"String","Value":"33333333-abc5-46db-9ad5-d772559ab556"},
    "ParticipantRole" : {"Type":"String","Value":"CUSTOMER"}
  }
}