API TouchPoint

To create your own TouchPoint integration, you can use the API TouchPoint feature. With this API you can connect your own conversational system with the ROGER365.io platform.

First add an API TouchPoint via the portal. How to do this can be found here.

API URL POST

https://api.roger365.io/api/apiendpoint/listener

‍

JSON body for POST to API touchpoint listener

{
  "From": "",
  "To": "",
  "ConversationId": "",
  "Content": {
    "Text": ""
  },
  "EndpointKey": ""
}

‍

• From: The id of the remote participant. This may not contain the scheme (scheme is configured in the portal)
• To: The Identifier of the API TouchPoint taken from ROGER365 admin portal.
• ConversationId: Optional, a value that will be used to identify a conversation. If the conversation is closed in the platform
  a new conversation will be created. If this value is omitted, the value from the From field will be used.
• Content: An object with the content of the message with property text, which contains the actual message.
• EndpointKey: The key for this touchpoin

‍

Webhook content

{
  "TimeStampUtc": "",
  "EndpointKey": "",
  "From": "",
  "ConversationId": "",
  "To": "",
  "Content": {
    "Text": ""
  }
}

‍

• TimeStampUtc: The time this message was scheduled to be send
• EndpointKey: The key for this touchpoint
• From: The name of the endpoint configuration
• ConversationId: The value for this conversation. In case of an OUT-message, this will contain an unique value.
• To: The id of the remote participant.
• Content: An object with the content of the message with property text, which contains the actual message.

‍