Omnichannel Setup

Introduction

We are delighted to present a powerful addition, a feature that empowers users to take specific actions based on the delivery statuses of notifications. This enhanced capability leverages Omnichannel communication and integrates seamlessly with webhooks, allowing clients to harness real-time data and automation for a more responsive and personalized customer experience. With this feature, users can define custom actions that correspond to various delivery statuses, ensuring that their interactions with customers are not only timely but also tailored to Specific Requirements.

Omnichannel Phase 1

User can set up a system to keep track of the status of your SMS notifications and activate a default webhook to capture detailed data throughout the entire notification process. This webhook acts as a central storage point for essential information regarding the status and progression of your SMS notifications.

Steps to Setup

  • Step-1:

To activate the Omnichannel feature in the Central MySQL Database where some adjustments must be made within the "Accountconfig" table. These changes pertain specifically to the account with Omnichannel enabled. For your account, when your Account ID is detected, the value in the "account.sms.notifyOnDelivery" column should be configured to "true". This modification ensures that the Omnichannel feature is enabled for your account. The effect of this change will be visible in the Support UI under the User Account Configuration section.

 

  • Step-2:

In the Central Web UI under Setup section in webhook tab a default webhook can be set.

Set the webhook as default

 

  • Step-3:

While Setting up the Flow, In the Detail section user need to enable the Webhook for the Flow.

Functionality of this feature through Default Webhook

 

  • If an SMS widget is included in the flow, the Default Webhook (API) will be triggered twice. The first trigger occurs on flow complete, and the second trigger occurs when the delivery status of the SMS is received in the SMSDetailDocument (MongoDB). In general, the webhook will be invoked twice, first on flow complete, and then again when the delivery status is received.

  • the webhook (API response) content is stored in the SMSdetaildocument under the column “notify_on_delivery

  • To include the flow keys in the final API, set the "account.sms.notifyOnDelivery.attachflowkeys" value to true in "Accountconfig" table.

 

The Second Time Invoked API Request Body Format (Sample):

{ "phonon-uuid": "bd706f90-aa14-47ea-9844-3d1e1123f4ee", "smsDetails": [ { "id": "290a4138-5729-475f-95e1-9ff30f851d67", "attemptDetail": "bd706f90-aa14-47ea-9844-3d1e1123f4ee##1", "phononUuid": "bd706f90-aa14-47ea-9844-3d1e1123f4ee", "flowId": 200, "accountID": 28, "length": 46, "cost": { "currency": { "currencyID": 1, "currencyName": "INR" }, "amount": 0.75, "serviceCategory": "53", "serviceChargeType": "Unit", "smsUnit": 1 }, "nonEnglishChars": true, "smsType": "NORMAL", "text": "फोनन में आपका स्वागत है $flow.key.sms. Phonon", "to": "919999999999", "from": "PHONON", "sendTime": "2023-10-19T11:55:20.408+05:30", "deliveryStatus": "DELIVERED" "deliveryTime": "2023-10-19T11:59:12.408+05:30", } ], "keys":[ { "name":"$flow.key.type", "value":"template" } ] }

This document has been developed by Phonon.io for the sole and exclusive use of the customer / prospective customer with whom this document is being shared. Further, this document has been provided by Phonon.io to the recipient in good faith and based on request from the recipient for the same. This document is a confidential document and contains confidential product technology, workflow and commercial details that are for the sole usage of the intended recipients of this document. Recipients are advised not to share this document with any third party that is not the intended recipient of this document and neither to bring this document in full or parts into the public domain. Any unauthorized access may be brought to Phonon.io’s notice immediately. Phonon.io is free to take any legal action it deems necessary against any person or entity that violates this confidentiality agreement. Phonon.io is bound and governed by the rules of the state of Gujarat in India. In case you are not in agreement with the terms set in this clause or are not an intended recipient of this document, please destroy the document and intimate us of the same at info@phonon.io.