How to Use Diyalog Web App in Iframe

You can use Diyalog web applications in iframe. In iframe usage, Diyalog application must first check whether the user who opened it is authenticated in the main application. For this, Dyialog needs token-based authentication. First of all, you are expected to generate a token for your user (your customer representative) in the main application where you opened Diyalog in iframe and give us an API with which we can verify this token. You can see the structure of the token verification API that you will give us from the link CheckToken.

You can review the diagram below for the token verification flow.

Online Help Diyalog Web Application

The following url information can be used to start a Diyalog chat with a customer in an iframe.

https://<your diyalog webapp server>/app/agentchat.html#/auth?customerId=<canlı yardım için gelen müşteri numarası>&userId=<Çağrı merkezi temsilci sicil numarası>&sessionId=<temsilcinin session idsi>&userName=<Temsilci Ad ve Soyadı>&dlgToken=<temsilcinin login olup olmadığını kontrol etmek için oluşturulan token bilgisi>&isOutbound=<true/false>

Sample url with query parameters:

https://localhost:3000/app/agentchat.html#/auth?customerId=23373681&userId=45186&sessionId=a221223223232323232323&userName=Ad%20Soyad&dlgToken=a1sasadadadasdasd_dasdqeqwfdfadaa&isOutbound=false

Details of query parameters:

Field Name	Type	Definition
customerId	String	Customer id to initiate Diyalog chat
userId	String	User id that started the Diyalog chat
userName	String	Name of the that started the Diyalog chat
sessionId	String	Unique id for session that corralated with token and userId
token	String	Token that will be verified by your system in order to be sure about the agent is authentication in the openned Diyalog app as iframe.
isOutbound	String	It is an indicator that shows whether the conversation is outbound or not. Default is false.