Create WhatsApp link
create_whatsapp_linkMakes a WhatsApp click-to-chat (wa.me) link. Use when the user wants to send a WhatsApp message or customer reply. Needs text. phone is optional: with a phone the link opens that chat, without it WhatsApp asks the user to pick a contact. The phone number is reduced to its digits with country code. Opens WhatsApp or WhatsApp Web with the message filled in, and the user presses send. Nothing is sent or stored. Do not use for Instagram, LinkedIn, SMS or bulk email: Send Out cannot send those, so tell the user and offer an email draft instead.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| text | Yes | Message as plain text with line breaks (at most 4,096 characters), such as "Your appointment is confirmed for Tuesday at 3pm." | |
| phone | No | Optional recipient phone number with country code, such as +14155552671. Spaces, dashes and brackets are removed; 5 to 15 digits must remain. Leave empty to let the user pick a contact. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| notes | Yes | Short notes to pass on to the user, including any warning. | |
| phone | Yes | Normalized recipient phone digits or null. | |
| status | Yes | Always ok when the link was made. Bad input returns an error instead. | |
| wa_url | Yes | Official wa.me click-to-chat deep link. | |
| warning | No | Warning if URL exceeds safe limits. | |
| url_length | Yes | Total length of the generated wa.me URL. | |
| character_count | Yes | Length of the message text in characters. |