# Send a message

Send a message via WhatsApp, Instagram, or Facebook Messenger.
Requires API key authentication.

Endpoint: POST /api-send-message
Version: 1.1.0
Security: ApiKeyAuth

## Request fields (application/json):

  - `to` (string, required)
    Recipient identifier. Format depends on channel:
- WhatsApp: Phone number (e.g., "+573188779043" or "573188779043")
- Instagram: Instagram user ID (e.g., "828925823321473"). You can also use the prefix "ig_" (e.g., "ig_828925823321473").
- Facebook Messenger: Facebook user ID (e.g., "123456789"). You can also use the prefix "fb_" (e.g., "fb_123456789").
    Example: "+573188779043"

  - `message` (string, required)
    Message content
    Example: "Hello, how can I help you?"

  - `channel` (string)
    Channel to send message through.
- whatsapp: Default for phone numbers
- instagram: For Instagram DMs
- facebook or messenger: For Facebook Messenger
    Enum: "whatsapp", "instagram", "facebook", "messenger"

  - `mediaUrl` (string)
    URL of media file (image, video, audio, document)

  - `mediaType` (string)
    Type of media if mediaUrl is provided
    Enum: "image", "video", "audio", "document"

  - `from` (string)
    Phone number to send from (WhatsApp only, uses default if not specified)

  - `quotedMessageId` (string,null)
    WhatsApp message ID (wamid.xxx) of the message to quote/reply to (WhatsApp only)
    Example: "wamid.HBgMNTczMTg4Nzc5MDQzFQIAERgSOTg5ODFCMTQ5ODMzQTJCOTZGAA=="

  - `quotedMessageMetadata` (object,null)
    Metadata of the quoted message (optional, used for display)

  - `quotedMessageMetadata.type` (string)
    Enum: "text", "image", "video", "audio", "document"

  - `quotedMessageMetadata.content` (string)

  - `quotedMessageMetadata.caption` (string,null)

  - `quotedMessageMetadata.url` (string,null)

## Response 200 fields (application/json):

  - `success` (boolean)

  - `messageId` (string)
    Message ID from the provider

  - `recipientId` (string)
    Recipient ID (for Instagram/Messenger)

  - `provider` (string)
    Provider used to send the message
    Enum: "evolution", "meta", "instagram", "messenger"

  - `data` (object)
    Raw response from the messaging provider

## Response 400 fields (application/json):

  - `error` (string, required)
    Error message

## Response 401 fields (application/json):

  - `error` (string, required)
    Error message

## Response 404 fields (application/json):

  - `error` (string, required)
    Error message

## Response 500 fields (application/json):

  - `error` (string, required)
    Error message