Skip to main content

Locobuzz Live Chat

Yellow.ai’s integration with Locobuzz Live Chat lets you connect with the live chat agents of Lococbuzz to resolve your support queries.

1. Connect Locobuzz with Yellow.ai

To configure Locobuzz integration in your yellow.ai account, follow these steps.

1.1 Enable the integration in Yellow.ai's Integration module

  1. Login to cloud.yellow.ai and click the Integrations module on the top left corner of your screen.
drawing
  1. Search for Locobuzz Live Chat or choose the category named Live chat from the left navigation bar and then click on Locobuzz Live Chat.
drawing
  1. Fill in the required fields.
  • Api Key (To be provided by the client/locobuzz spoc of the client)
  • Company Name (To be provided by the client/locobuzz spoc of the client)
  • Api Domain (To be provided by the client/locobuzz spoc of the client)
  • Channel Id (To be provided by the client/locobuzz spoc of the client)
  • Ticket Queue Message (This message will be displayed if the ticket goes into a queued state).
  1. Once you're done, click Connect.

1.2 Configure webhook URL in Locobuzz Dashboard

To receive events, you need to configure the webhook URL in the Locobuzz Dashboard.

Copy the webhook url and the api key mentioned in the Instructions section of the Locobuzz Integration Card. Append the region of your bot to the domain of the webhook url. r1/r2/r3/r4/r5 are the regions of your bot, you can refer the following list for the same.

  • r1 = MEA
  • r2 = Jakarta
  • r4= USA
  • r5 = Europe
  • r3 = Singapore

1.3 Enable events in Yellow.ai bot

  1. Login to cloud.yellow.ai and click the Studio module on the top left corner of your screen.
drawing
  1. Click Event on the left navigation bar and click Integrations.
drawing
  1. Enable the following events on this page:
  • locobuzz-agent-inactivity - This event is triggered when the agent is inactive.
  • locobuzz-agent-logout - This event is triggered when there is an unexpected network/system issue at the agent’s end.
  • locobuzz-customer-inactivity - This event is triggered when the customer is inactive for more than a minute. Activate this event by clicking the three dots next to the name of the event.
  1. After activating these events, a flow needs to be created in Studio whose trigger point will be this event. Based on the received event data, an appropriate message will be displayed to the end user.
drawing

Sample webhook event data sent by Locobuzz:


{
"ticketId": 287267,
"senderId": "8f800f85-6143-4710-8b3a-1f4c3e4fa2b0",
"source": "yellowmessenger",
"event": "customer-infoawaited",
"agentName": "Prashant Pange",
"agentId": "33619",
"ticketAssignedTime": 1665476293
}

2. Use-case

This integration lets you connect with live agents on Locobuzz from your yellow.ai account.

2.1 Chat with Locobuzz Live Agent

  1. In the Studio flow builder, select the Raise Ticket node.
drawing
  1. Select Locobuzz Live Chat from the Live chat agent drop-down list.
drawing

The following table contains the details of each field of the Raise ticket node.

Field nameSample valueData typeDescription
Message after ticket assignmentRequesting live agent connection.StringThe message that will be displayed to the end user after a ticket is successfully assigned to an agent
NameRajeshStringName of the end user
Mobile9876543210StringMobile number of the end user
Email[email protected]StringEmail address of the end user
QueryI have a concern regarding my flight ticketStringThe subject/topic/reason why the ticket was created
PriorityMediumStringThe priority of the ticket

Sample success response

{
"assignedTo": true,
"success": true,
"status": "ASSIGNED",
"ticketInfo": "{{apiresponse}}"
}
note

apiresponse represents the raw response from the Locobuzz create ticket API

Sample failure response

{
"success": false,
"assignedTo": false,
"agentNotAvailable": true,
"message": "TicketId is not created and transferring the control back to the bot",
"ticketInfo": "{{apiresponse}}"
}
note

apiresponse represents the raw response from the Locobuzz create ticket API