`whatsapp_send`

Send a WhatsApp message to a contact with a pre-approved template.

Category: Messaging
Stability: Beta
Version: v1
Auth: cf-access

Input schema

{
  "type": "object",
  "properties": {
    "to": { "type": "string", "description": "E.164 phone number, e.g. +33612345678" },
    "template": { "type": "string", "description": "Pre-approved template name." },
    "params": { "type": "object", "additionalProperties": { "type": "string" } },
    "language": { "type": "string", "enum": ["fr", "en"], "default": "fr" }
  },
  "required": ["to", "template"]
}

Output schema

{
  "type": "object",
  "properties": {
    "message_id": { "type": "string" },
    "queued_at": { "type": "string", "format": "date-time" }
  }
}

Example invocation

{
  "tool": "whatsapp_send",
  "arguments": {
    "to": "+33612345678",
    "template": "order_confirmed",
    "params": { "order_id": "SO-2026-04-1042", "ship_date": "2026-04-28" },
    "language": "fr"
  }
}

Example response

{
  "message_id": "wam_01JK3R2F0",
  "queued_at": "2026-04-22T13:05:00Z"
}

WhatsApp Business API only allows pre-approved templates for outbound. Free-form replies are allowed for 24 hours after a customer-initiated message — that path is not yet exposed as a tool.