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": "you@example.com",
      "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.

Last updated