Embed WhatsApp Conversations Inside Your Product

DoubleTick allows you to embed a live WhatsApp conversation directly inside your application using a secure iframe URL.

This is useful when you want your users, agents, or support teams to view and manage WhatsApp chats without leaving your platform.

Common use cases include:

• CRM platforms showing customer conversations beside lead details
• Support dashboards with embedded WhatsApp chats
• Internal tools for sales or operations teams
• Custom admin panels with integrated messaging
• SaaS products offering WhatsApp communication inside their UI

The embedded interface is fully hosted and managed by DoubleTick, allowing users to interact with WhatsApp conversations directly from your platform.

Create WhatsApp Conversation Embed URL

Use the following endpoint to get an embed URL for a WhatsApp conversation:

POST https://public.doubletick.io/embed/url

Request Headers

{
  "Authorization": "YOUR_API_KEY",
  "Content-Type": "application/json"
}

📘

NOTE

If you do not have your DoubleTick API Key, you can obtain it by following this guide:
https://docs.doubletick.io/docs/quickstart-guide#step-2-generate-your-api-key

Request Body Parameters

{
  "phone": "919876543210",
  "integrationId": "intg_xxxxxxxxxx",
  "wabaNumber": "919000000000"
}

Parameters

• phone (string, required):
  • WhatsApp phone number of the contact in international format.
  • No + or spaces.
• integrationId (string, optional):
  • DoubleTick integration ID (e.g., intg_xxxxxxxxxx).
  • If not provided, the primary connected WhatsApp integration is used automatically.
• wabaNumber (string, optional):
  • WhatsApp Business Account number in international format.
  • Ignored if integrationId is also provided.

📘

NOTE

This API generates a secure embeddable URL for a WhatsApp conversation.

The generated URL can be used inside an iframe to display:

• A specific customer conversation
• The DoubleTick messaging interface

The embed automatically opens the conversation associated with the provided phone number.

Responses

Success Response (200)

{
  "url": "https://webextend.doubletick.io/embed/conversations/intg_xxxxxxxxxx/customer_xxxxxxxxxx?showChatListPanel=false&showCustomerDetails=false&showSidebar=false"
}

Bad Request (400)

{
  "message": "error_message",
  "error": "Bad Request",
  "statusCode": 400
}

Unauthorized (401)

{
  "message": "Invalid public api key",
  "error": "Unauthorized",
  "statusCode": 401
}

Not Found (404)

{
  "message": "No connected WhatsApp integration found",
  "error": "Not Found",
  "statusCode": 404
}

Using the URL

Once you receive the url in the response, use it directly as the src of an iframe in your application:

<iframe
  src="https://webextend.doubletick.io/embed/conversations/intg_xxxxxxxxxx/customer_xxxxxxxxxx?showChatListPanel=false&showCustomerDetails=false&showSidebar=false"
  width="400"
  height="600"
  frameborder="0"
/>

Best Practices

• Always pass the phone number with the country code and no special characters (e.g., 919876543210 not +91 98765 43210).
• Use integrationId or wabaNumber when you want to open the conversation with particular WhatsApp business number.
• Leave showChatListPanel, showCustomerDetails, and showSidebar as false (default) for a focused single-conversation embed with no distractions.
• Set all three to true if you want to give users access to the full DoubleTick interface inside the embed.