http://localhost:8000    # Development
https://agent.olive.example.com  # Production

{
  "status": "healthy",
  "service": "olive-agent-ts",
  "activeConversations": 5
}

curl http://localhost:8000/health

curl -X DELETE "http://localhost:8000/api/v1/conversation/+23279123456"

{
  "event": "message",
  "message": "What is my balance?",
  "from": "23279123456@c.us",
  "phoneE164": "+23279123456"
}

{
  "event": "message",
  "messageType": "image",
  "hasMedia": true,
  "phoneE164": "+23279123456",
  "message": "Here is my ID",
  "media": {
    "data": "data:image/jpeg;base64,/9j/4AAQSkZJRg...",
    "mimetype": "image/jpeg",
    "filename": "id_card_front.jpg",
    "size": 52643
  }
}

{
  "answer": "Your balance is 5,000 SLE",
  "status": "success"
}

curl -X POST "http://localhost:8000/api/v1/external/whatsapp" \
  -H "Content-Type: application/json" \
  -d '{
    "event": "message",
    "message": "check my balance",
    "phoneE164": "+23279123456"
  }'

curl "http://localhost:8000/api/v1/webhooks/whatsapp?hub.mode=subscribe&hub.verify_token=YOUR_TOKEN&hub.challenge=CHALLENGE"

{
  "object": "whatsapp_business_account",
  "entry": [{
    "id": "WHATSAPP_BUSINESS_ACCOUNT_ID",
    "changes": [{
      "value": {
        "messaging_product": "whatsapp",
        "metadata": {
          "display_phone_number": "15551234567",
          "phone_number_id": "PHONE_NUMBER_ID"
        },
        "contacts": [{
          "profile": { "name": "John Doe" },
          "wa_id": "23279123456"
        }],
        "messages": [{
          "from": "23279123456",
          "id": "wamid.xxx",
          "timestamp": "1234567890",
          "type": "text",
          "text": { "body": "What is my balance?" }
        }]
      }
    }]
  }]
}

X-Service-Name: wallet-core
X-Service-Timestamp: 1710072000
X-Service-Signature: <hex-hmac>

{
  "phoneE164": "+23279123456",
  "message": "You received 5,000 SLE from John Doe",
  "transactionType": "p2p_transfer",
  "metadata": {
    "amount": 5000,
    "currency": "SLE",
    "sender_name": "John Doe",
    "transaction_id": "txn_abc123"
  }
}

{
  "phoneE164": "+23279123456",
  "template": {
    "name": "payment_reminder",
    "languageCode": "en",
    "components": [
      {
        "type": "body",
        "parameters": [
          { "type": "text", "text": "John" },
          { "type": "text", "text": "SLE 500" }
        ]
      }
    ]
  }
}

{
  "success": true,
  "message": "Receipt image sent",
  "details": { "messageId": "msg_123" }
}

curl -X POST "http://localhost:8000/api/v1/notifications/whatsapp" \
  -H "X-Service-Name: wallet-core" \
  -H "X-Service-Timestamp: 1710072000" \
  -H "X-Service-Signature: 5d41402abc4b2a..." \
  -H "Content-Type: application/json" \
  -d '{
    "phoneE164": "+23279123456",
    "message": "Payment received: 5,000 SLE"
  }'

{
  "error": "Error description",
  "status": "error"
}