> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lancer-erp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# UChat (WhatsApp)

> Business WhatsApp through UChat: Lancer sends messages, payment links and reminders through your UChat workspace, and incoming messages land in Lancer's inbox.

Business WhatsApp through UChat: Lancer sends messages, payment links and reminders through your UChat workspace, and incoming messages land in Lancer's inbox.

> [!NOTE]
>
> **Category:** WhatsApp and messaging ("וואטסאפ והודעות")\
> **Connection:** one for the whole organization, admins only

## What it does in Lancer

* Send WhatsApp messages, payment links, reminders and team notifications.
* Pick approved templates per purpose for messages outside WhatsApp's 24-hour window.
* Incoming messages land in the client's conversation; an unknown number creates a new lead.

## Connect

**1. Open the integration**

Open Settings → **Integrations** ("הגדרות" → "אינטגרציות"), at [app.lancer-erp.com/app/settings/integrations](https://app.lancer-erp.com/app/settings/integrations). Under **WhatsApp and messaging** ("וואטסאפ והודעות"), find **UChat (WhatsApp)** and click **Connect** ("חיבור").

**2. Get your credentials**

UChat → Settings → API Keys.

**3. Fill in the card and save**

Enter the details below and click **Save** ("שמירה"). Secrets are stored encrypted and never shown again; leave a secret field empty later to keep the stored value.

**4. Finish**

Click **Test connection** ("בדיקת חיבור").

> [!NOTE]
>
> Only admins can view and change this connection.

## What you need

**API key** `string`

Your UChat workspace's API key (UChat → Settings → API Keys).

**Payment link flow** `string`

Optional: the name of a flow that sends an approved template before the link. In the app: "Flow לקישור תשלום".

**Team notification flow** `string`

Optional: the flow used for staff notifications. In the app: "Flow להתראות צוות".

**Templates** `string`

Approved templates per purpose, created in UChat (WhatsApp → Templates). In the app: "תבניות וואטסאפ".

## Webhook and notify URLs

The exact URL, with your organization's token in place of `<token>`, is shown on the card in Lancer. Copy it from there.

### Inbound webhook

```text theme={null}
https://api.lancer-erp.com/webhooks/uchat/inbound/<token>
```

In UChat, create a flow triggered on every incoming message with an **External Request** action: `POST` to this URL with the JSON body `{ "phone": "{{phone}}", "name": "{{full_name}}", "text": "{{last_text_input}}", "user_ns": "{{user_ns}}", "mid": "{{mid}}" }`.

## Good to know

* With both UChat and the WhatsApp Cloud API connected, an admin picks which one sends. Incoming messages from both go to the same conversation.

## Vendor documentation

> [card] [UChat (WhatsApp) documentation](https://www.uchat.com.au/api)
>
> The official docs, at [www.uchat.com.au](http://www.uchat.com.au).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.