Step 4: Creating an In-App External Action

Follow these steps to create an External Action:

  1. Navigate to Administration > External action list screen, click + Add new external action.
  1. The Create external action screen appears. You can choose to create a new action or select an action which is saved as a template earlier. Select New to create a new action and click Proceed.
1032
  1. On the Action settings screen, enter details for the following fields:

    • Action name: Enter a name for the action.

    • Target system: Select a target system associated with the user from which an action is to be retrieved. When a network event is triggered, the application connects to the system to fetch and performs the corresponding configured action dynamically in real-time.

    • Action type: Select the action type associated with the target system.

    • Max TPS: Enter the maximum TPS.

📘

This TPS is shared between Webex Campaign and use-cases deployed in Webex Connect. Please ensure that this TPS is unused in Webex Connect, during the campaign deployment schedule.

  • Response type: Select the data transfer method as Synchronous. When an action is received from the target system then it is processed in real-time.

  • Raise an alert if more than: Enter the percentage of actions that result in failure within an hour to raise an alert.

  • Description: Enter a meaningful description for the action.

  1. Click Mode accordion and select configure the following:

    • Mode: Select the mode as Webex Connect Workflow from the drop-down.
    • Webex connect service: Select the Webex Connect service in which the RCS flow was created.
    • Webex connect flow: Select the RCS flow from the drop-down.
    • Flow webhook URL: The webhook URL will be populated automatically.
    • Method type: Select the method type as POST from the drop-down.
    • Action timeout: Maximum period the system should wait to receive an action response before logging it as failed. The default value is 2000 milliseconds (2 seconds).
WhatsApp
  1. Do not select anything in the Authorization type.

  2. Click Headers accordion and click +Add new and enter header details as shown below:

NameDescriptionApplicable toOptionsDatatype/valueDisplay type
KeyKeyActionMandatoryPlain Text
Content-TypeContent-TypeActionMandatoryapplication/jsonPlain Text
1673
  1. Do not enter anything in the URL parameters.

  2. Enter the body parameters as shown below.

NameDescriptionLevelOptionsData type/valueDisplay typeData source
MSISDNMSISDNDeploymentMandatoryDynamicList BoxTG Attributes
deploymentIddeployment idDeploymentMandatoryTextTextboxnot applicable
Enter Personalization header (optional)some descriptionDeploymentMandatoryDynamicList BoxTG Attributes

📘

If you want to personalize a message, make sure the header is available in the TG that is selected in the RCS deployment, added in the RCS message in Webex Connect and an entry of the header under body parameters. The values of the personalization header will be same as MSISDN header.

  1. Do not enter anything in the Output parameters.
  2. Enter the response code and description under Success responses as shown below:
Response codeDescriptionDefinition
1002SuccessReturned when the request is accepted by Webex Connect.
  1. Enter the response codes and descriptions under Failure responses as shown below:
Response CodeDescriptionDefinition
7000Invalid JSONReturned when an invalid JSON request is sent.
7001Authentication failedReturned when an invalid service key or profile key is provided in the request.
7002Service Key MissingService key is missing in the inbound webhook request.
7005Internal error occurredReturned when there is an issue with Webex Connect.
7007Service inactiveThe service does not exist or is deleted.
7008Request received on an invalid or unsaved event endpointThe inbound webhook endpoint does not exist.
7010Source IP is not allow listedSource IP is not in the allow list of IPs.
7020You have reached maximum transaction limitReturned when you have reached the transaction limit.
7027Invalid XMLReturned when an invalid XML request is sent.

  1. Click Save.