Actions27
- Contact Actions
- Group Actions
- Guardrail Actions
- Message Actions
- Session Actions
Message → Send Text
AI-generatedSummary
Send a text message via a specified WhatsApp session to a given recipient number or JID, optionally handling first contact status and deduplication.
Inputs
- Session (Name or ID) (required) — The name or ID of the WhatsApp session to send the message through.
- To (required) — The recipient's phone number in full international format (DDI+DDD+number) or the complete JID.
- Text (required) — The text content of the message to be sent.
- Cold (First Contact) — Indicates whether this message is a permissioned first contact (cold). Should be false for AI or agent replies.
- Idempotency Key — Optional unique key to prevent message duplication; retrying with the same key returns the previous result without resending.
- Continue on Quarantine — If true, when the session is quarantined (HTTP 423 error), the node outputs a JSON object describing the block instead of erroring, allowing workflow branching.
Output shape
a single item with JSON content describing the message send result or quarantine block.
If 'Continue on Quarantine' is enabled and the session is quarantined, the output JSON includes { blocked: true, reason, code } instead of throwing an error. Other HTTP errors cause failure. The operation returns the API response object from the Telegram Gateway endpoint on success.
Examples
Example 1: Send a simple WhatsApp text message
Set 'Session' to your session identifier, 'To' to the recipient's full phone number, and 'Text' to your message content. Optionally enable 'Cold' if this is a first contact and provide an 'Idempotency Key' for safe retries.