# Wati

Wati is a WhatsApp Business API platform that automates marketing, sales, service, and support.

- **Category:** marketing automation
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 5
- **Triggers:** 0
- **Slug:** `WATI`
- **Version:** 20260227_00

## Tools

### Add Contact

**Slug:** `WATI_ADD_CONTACT`

Tool to add a new contact in WATI. Use when registering a customer's WhatsApp number before sending messages.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Display name of the contact, e.g., 'Alice Johnson'. |
| `customParams` | array | No | List of custom key/value attributes for the contact. |
| `whatsappNumber` | string | Yes | WhatsApp number including country code, digits only (no '+' or spaces), length 6-15. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Teams

**Slug:** `WATI_GET_TEAMS`

Tool to retrieve a list of teams from WATI. Use after authenticating when you need to enumerate all available teams.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Send Session Message

**Slug:** `WATI_SEND_SESSION_MESSAGE`

Tool to send a session message to a specified WhatsApp number. Use when you need to deliver a free-form text within an active 24-hour session window.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `messageText` | string | Yes | The text of the message to be sent in the active session. |
| `whatsappNumber` | string | Yes | Recipient's WhatsApp number with country code (digits only, without '+' or spaces). Example: 85264318721 |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Wati update chat status

**Slug:** `WATI_UPDATE_CHAT_STATUS`

Update the status of a chat/conversation in WATI Team Inbox. This action allows you to change the status of a customer's chat to help manage ongoing conversations. Available statuses: - OPEN: Active, two-way conversation - PENDING: Waiting for customer's response - SOLVED: Issue has been resolved - BLOCK: Prevent further communication with the contact

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `ticket_status` | string ("OPEN" | "SOLVED" | "PENDING" | "BLOCK") | Yes | The status to set for the chat. Allowed values: OPEN (active conversation), SOLVED (issue resolved), PENDING (waiting for customer response), BLOCK (prevent further communication). |
| `whatsapp_number` | string | Yes | The customer's WhatsApp phone number (e.g., '1234567890'). Must include country code without '+' or spaces. |
| `channel_phone_number` | string | No | The business channel phone number. Required for accounts with multiple WhatsApp numbers. Must include country code without '+' or spaces. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Contact Attributes

**Slug:** `WATI_UPDATE_CONTACT_ATTRIBUTES`

Tool to update attributes of an existing contact. Use after confirming the contact exists and you need to modify its custom attributes.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `customParams` | array | No | Optional list of custom attributes to update for the contact. Each item should include a name and value. |
| `whatsappNumber` | string | Yes | Target contact's WhatsApp number in international format with '+' and country code. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |