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

# Send text

> Send WhatsApp text messages

Sends text messages to users via WhatsApp.

## Configuration

* `whatsapp_config_id`: WhatsApp connection to use (optional; falls back to the conversation)
* `phone_number_id`: WhatsApp Business phone number ID to use (preferred for local/API source)
* `message`: Text content (string or AIField)
* `provider_model_name`: Required when using AIField
* `to_phone_number`: Override destination phone number (optional; required for observer mode flows)

## Workflow library example

```javascript theme={null}
workflow.addNode("send_intro", {
  type: "send_text",
  message: "Hi {{vars.customer_name}}, how can we help?",
  phoneNumberId: "<phone-number-id>"
});
```

## Variable interpolation

Use variables in messages:

```
Hi {{customer_name}}, your order {{order_id}} is ready!
```

## Usage patterns

**Welcome message**

```mermaid theme={null}
graph LR
    A[Start] --> B[Send Text<br/>Welcome]
    B --> C[Wait for Response]
```

**Response after decision**

```mermaid theme={null}
graph LR
    A[Decide] --> B[Send Text<br/>Support info]
    A --> C[Send Text<br/>Sales info]
```