Send WhatsApp Message Tool

POST /api/agents/tools/sendWhatsApp

{
  "phone_number": "+1234567890",
  "message": "Hello! Thank you for your interest in our product. How can I help you today?",
  "from": "Sales Team",
  "site_id": "site-uuid-here",
  "agent_id": "agent-uuid-here",
  "conversation_id": "conv-uuid-here",
  "lead_id": "lead-uuid-here"
}

WHATSAPP_PHONE_NUMBER_ID=your_phone_number_id
WHATSAPP_API_TOKEN=your_whatsapp_api_token

{
  "channels": {
    "whatsapp": {
      "phoneNumberId": "your_phone_number_id",
      "accessToken": "your_whatsapp_api_token"
    }
  }
}

{
  "success": true,
  "message_id": "wamid.unique_message_id",
  "recipient": "+1234567890",
  "sender": "Sales Team",
  "message_preview": "Hello! Thank you for your interest in our product. How can I help you today?",
  "sent_at": "2024-01-15T10:30:00.000Z",
  "status": "sent"
}

{
  "success": true,
  "message_id": "temp-uuid-here",
  "recipient": "no-phone-example",
  "sender": "Sales Team",
  "message_preview": "Hello! Thank you for your interest in our product. How can I help you today?",
  "sent_at": "2024-01-15T10:30:00.000Z",
  "status": "skipped",
  "reason": "Temporary phone number - no real message sent"
}

{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Human readable error message"
  }
}

GET /api/agents/tools/sendWhatsApp?agent_id=uuid&limit=10

{
  "success": true,
  "messages": [
    {
      "id": "log-uuid",
      "recipient_phone": "+1234567890",
      "sender_name": "Sales Team",
      "message_content": "Hello! Thank you for your interest...",
      "whatsapp_message_id": "wamid.unique_message_id",
      "agent_id": "agent-uuid",
      "conversation_id": "conv-uuid",
      "lead_id": "lead-uuid",
      "sent_at": "2024-01-15T10:30:00.000Z",
      "status": "sent"
    }
  ],
  "count": 1
}

curl -X POST https://your-domain.com/api/agents/tools/sendWhatsApp \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-token" \
  -d '{
    "phone_number": "+1234567890",
    "message": "Hello! Thank you for your interest in our product.",
    "from": "Sales Team",
    "site_id": "site-uuid-here"
  }'

const response = await fetch('/api/agents/tools/sendWhatsApp', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer your-token'
  },
  body: JSON.stringify({
    phone_number: '+1234567890',
    message: 'Hello! Thank you for your interest in our product.',
    from: 'Sales Team',
    site_id: 'site-uuid-here',
    agent_id: 'agent-uuid-here',
    conversation_id: 'conv-uuid-here'
  })
});
 
const result = await response.json();
console.log(result);

import requests
import json
 
url = "https://your-domain.com/api/agents/tools/sendWhatsApp"
headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer your-token"
}
data = {
    "phone_number": "+1234567890",
    "message": "Hello! Thank you for your interest in our product.",
    "from": "Sales Team",
    "site_id": "site-uuid-here",
    "agent_id": "agent-uuid-here"
}
 
response = requests.post(url, headers=headers, data=json.dumps(data))
result = response.json()
print(result)