---
title: "Embed Chat Conversation"
method: POST
path: "/embed/url"
tags: ["Embed"]
---

# Embed Chat Conversation

`POST /embed/url`

Returns a ready-to-use iframe URL that opens a specific WhatsApp conversation for a given contact's phone number directly inside your application. The contact's phone number is never exposed in the returned URL.

## Request body

- GetEmbedUrlDto
  - `phone` string, required — WhatsApp phone number of the contact in international format. No + or spaces.
  - `integrationId` string — DoubleTick integration ID (intg_xxx). If omitted, the primary connected WhatsApp integration is used automatically.
  - `wabaNumber` string — WhatsApp Business Account Number

## Response `200`

Success

- object
  - `url` string — Full embed URL. Use directly as the src of an iframe.

## Other responses

- `400` — Incorrect payload
- `401` — Unauthorized
- `404` — NotFound

---

[API](https://skmtc.net/doubletick/apis/doubletick-public-apis.md) · [All operations](https://skmtc.net/doubletick/apis/doubletick-public-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/doubletick/doubletick-public-apis/versions/bba484527d34/schema)