Configuring Messaging Services

You use this procedure to configure outgoing authentication for external services and for some, also the incoming authentication. If the setting Use Local Http Authentication is enabled in the SMS Server variables, you must configure also the incoming authentication except for Facebook Messenger and C4S.

Note:

Avoid deleting or modifying messaging services or their authentication during business hours, as this may lead to message delivery failures.

You can use either System Configurator (SC) or Restful Configuration Interface (RCI) for the configuration.

Prerequisites

SMS and Facebook integrations require the following software packages to be installed:

  • Chat Server

  • Chain Matcher

  • SMS Server

  • Restful Contact Management Interface (CMI) from the Restful Interface package

For more information about the installation, see the Installation Guide Installing Virtual Units for ECF.

Outgoing Authentication

You must have rights to create or modify messaging services.

  1. On the System Configurator main screen, choose System Management > Messaging Services.

  2. Click Add New.

    Note that twilio, sap365, and social365 are no longer supported.

  3. Choose the messaging service type and click OK.
  4. Configure the settings according to the following table.
    Table 1. Basic Settings

    Field

    Description

    Name

    Enter a descriptive name for the service.

    Service Connection

    This is the outgoing connection. Enter it in the URL format.

    Authentication URL

    The URL is https://auth.sinch.com/oauth2/token and it's used when configuring ougoing (Mobile Terminated) messages for sinchconversation.

    Authentication Scope

    Not applicable.

  5. In the Authentications block, enter the credentials for your service:
    Service Authentication ID Secret
    Microsoft Teams
    • Azure Application (client) ID
    • For a technical user: user name in an email format
    • Password
    • For a technical user: password
    facebook

    Page ID

    Page access token
    c4semail

    Username

    Password
    c4semailv2

    Username

    Password
    sinchconversation

    From Sinch Portal:

    • For outgoing: [Key ID]@[App ID]
    • For incoming: webhook
    Note:
    Enter the App ID in capital letters as it is in Sinch Conversation API.

    For more information, see the Configuring Sinch Conversation API

    • For outgoing: Secret from Sinch Portal > Settings > Access keys > Access key list
    • For incoming: your app’s secret from Conversation API > Apps > [the app] > Webhook > Secret token
    sinchsms

    Service plan ID

    API token
    wavy

    Username

    Password

  6. Save your changes.

Incoming Authentication

Note:

Facebook Messenger and C4S do not require incoming authentication. Additionally, this is not required if authentication is disabled in SMS Server. The incoming authentication for Sinch Conversation API is done with webhook in the Authentications block.

In this procedure you create an external user for incoming authentication.

You must have rights to create or modify users.

  1. On the System Configurator main screen, choose User and Role Management > User.

  2. Click Add New.

  3. The following lists the mandatory settings you must define for this user:

    • First Name

    • Last Name
    • Logon Name
    • Password

    It's recommened not to use an existing user.

  4. In User Rights block, give the user Use rights to Messaging Service.
  5. Save your changes.