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

1. 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": "[email protected]",
     "password": "your_password"
   }'

2. 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.