Iframe sidebar allows you to provide agents with supportive information by embedding any relevant web page, such as an internal CRM or order lists of your customers, into the Ticket details view.

https://s3-us-west-2.amazonaws.com/secure.notion-static.com/ac08717b-eb1f-4ffc-9c36-01ad77b23ea8/Untitled.png

To integrate on the dashboard

  1. Go to Settings > Integrations, and click Settings on Iframe sidebar.

    https://s3-us-west-2.amazonaws.com/secure.notion-static.com/16c94064-0a54-408f-96da-d23d838d269b/Untitled.png

  2. Fill out the information and click Save.

<aside> 💡 Note: Secret key is automatically generated when you set up Iframe sidebar.

</aside>

Operation process

The following steps further explain how Iframe sidebar operates after it is set up on your dashboard.

  1. Iframe sidebar is initialized using the Sendbird's internal URL. The internal URL is different from the URL registered when setting up the Iframe on your dashboard.

  2. Iframe sidebar requests HTML to the Desk server through Sendbird's internal URL.

  3. The Desk server sends an HTTP request to your server through the registered URL. At this point, Secret key and Token are also delivered to your server to verify the request being made.

  4. After the verification, an HTML response should be sent to the Desk server from your server.

  5. The Desk server proxies HTML to Iframe sidebar.

  6. The embedded website is displayed on the right sidebar of the Ticket details view.

<aside> 💡 Note: You can find your secret key in Settings > Integrations > Iframe sidebar. It is used to verify if an HTTP request is sent from the Desk server, which is encrypted and used to generate a value of an x-hub-signature header for HTTP requests.

</aside>

<aside> 💡 Note: Token is generated by the Desk server when there is a request from an agent who is authenticated on the Sendbird Dashboard. It is delivered from the Desk server to your server through html_key in the query parameter of the HTTP request, which can be used after the setup to verify if the request for data is sent from the Desk server. The token is valid only for 24 hours since its creation.

</aside>

Transmitted Data

When the Iframe sidebar is set, the following data types are delivered from the Desk server to your server in the form of the following URL. You can also utilize the transmitted data when requesting additional information using Platform API.

<aside> ➡️ https://desk-api-{region}.sendbird.com/api/apps_iframes/{apps_iframe_id}/get_html?html_key={html_key}&agent_id={agent_id}&ticket_id={ticket_id}

</aside>

Data type

<aside> 💡 Note: Apps_frame_id is the unique identifier of the Iframe upon its creation. If you create a new Iframe after deletion, a different ID will be provided.

</aside>