# 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:

   ```bash
   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:**

<pre><code><strong>https://conversation-widget.gallabox.com/auth?token=your_token&#x26;redirectUrl=https%3A%2F%2Fconversation-widget.gallabox.com%2Fconversations%2Fphone%2F919900000001%3Fname%3DLakshmanan%26channelId%3D647062b51e3c77d2741188cb
</strong></code></pre>

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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.gallabox.com/developer-resources/conversation-widget.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.