📱 WhatsApp QR

🔽 POST /api/public/web-whatsapp-message/send/{phoneId}/message – Send a Web WhatsApp Message

Sends a message from a connected WhatsApp Web session using the specified phoneId.

Click to expand full details

🔹 URL

POST /api/public/web-whatsapp-message/send/{phoneId}/message

🔹 Path Parameters

NameTypeRequiredDescription
phoneIdstringThe ID of the phone sending the message via WhatsApp Web

🔹 Query Parameters

NameTypeRequiredDescription
messagestringThe content of the message you want to send
stagestringContextual tag for the message (e.g., "checkout")
x-api-keystringYour API key for authenticating the request

🔹 Body

NameTypeRequiredDescription
phonestringThe Phone Number you want to send the message to

🔹 Example Request (cURL)

curl --request POST \
  'https://iris-backend-production.up.railway.app/api/public/web-whatsapp-message/send/abc123/message?message=Hello%20world&stage=welcome' \
  --header 'x-api-key: YOUR_API_KEY' \
  --header 'content-type: application/json'

Replace:

  • abc123 with your actual phoneId
  • YOUR_API_KEY with your real API key
  • message and stage as needed

🔹 Notes

  • The phone must be connected and authenticated via WhatsApp Web.
  • This endpoint is useful for real-time messages triggered by events on your own platform
  • Avoid excessive usage to prevent rate-limiting.

🔽 POST /api/public/ticket/open/web-whatsapp/{phoneId} – Open a New Ticket

Creates a ticket linked to a specific WhatsApp phone sender. Includes support for metadata, contact info, and message content.

Click to expand full details

🔹 URL

POST /api/public/ticket/open/web-whatsapp/{phoneId}

🔹 Path Parameters

NameTypeRequiredDescription
phoneIdstringThe phone ID used to send the WhatsApp message

🔹 Body Parameters

FieldTypeRequiredDescription
contact_namestringName of the contact
to_phone_numberstringWhatsApp number of the recipient
contact_metadataobjectOptional extra info about the contact
ticket_metadataobjectOptional structured data about the ticket
emailstringEmail address linked to the ticket
messageobjectInitial message content
stage_idstringUUID of the pipeline stage where ticket starts

🔹 Example Request

curl --request POST \
  'https://iris-backend-production.up.railway.app/api/public/ticket/open/web-whatsapp/phone_123' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    
    }
  }'

🔹 Success Response

🟢 200 Ticked created successfully