Conversation Widget
Conversation Widget can be seamlessly embedded into your internal CRM or portal by following the steps below:
Embedding the Conversation Widget in an iFrame
To embed the conversation widget, use the following URL format in an iFrame:
https://conversation-widget.gallabox.com/conversations/phone/{{ContactPhoneNumberwithCountryCode}}?name={{ContactName}}&channelId={{GallaboxChannelId}}
Parameters:
ContactPhoneNumberwithCountryCode: The WhatsApp user’s phone number with the country code, excluding the ‘+’. Example:
919900000001
.ContactName: The WhatsApp user’s contact name.
GallaboxChannelId: The Channel ID is required if your account has multiple WhatsApp channels. It can be found in Gallabox under
Settings > WhatsApp Channel > Channel Id
.
Example URL:
https://conversation-widget.gallabox.com/conversations/phone/919900000001?name=Lakshmanan&channelId=647062b51e3c77d2741188cb
Note: When loading the widget, the Gallabox account member must be logged in to their account.
Auto-login Widget with a Specific Member
Get Token from Server API Call
Use the following
curl
command to get the authentication token:curl --location 'https://server.gallabox.com/auth/v2/login' \ --header 'Content-Type: application/json' \ --data-raw '{ "email": "you@example.com", "password": "your_password" }'
Load iFrame with Auth URL with Token and Redirect URL
Use the token obtained in the previous step to load the iFrame with the following URL format:
https://conversation-widget.gallabox.com/auth?token={{AuthToken}}&redirectUrl={{ConversationWidgetUrl}}
Parameters:
AuthToken: The member’s authentication token obtained from the server API call.
ConversationWidgetUrl: The URL of the conversation widget in the format:
https://conversation-widget.gallabox.com/conversations/phone/{{ContactPhoneNumberwithCountryCode}}?name={{ContactName}}&channelId={{GallaboxChannelId}}
If the customer has enabled 2FA or user logs-in with new IP, widget will display OTP screen. After successful verifcation user will the navigated to desired redirect url Example URL:
https://conversation-widget.gallabox.com/auth?token=your_token&redirectUrl=https%3A%2F%2Fconversation-widget.gallabox.com%2Fconversations%2Fphone%2F919900000001%3Fname%3DLakshmanan%26channelId%3D647062b51e3c77d2741188cb
By following these instructions, you can successfully integrate the Gallabox Conversation Widget into your internal systems, ensuring seamless communication via WhatsApp through your portal or CRM.
Last updated