Vai al contenuto

Write on WhatsApp through our APIs

This feature allows your management software or any other external software to communicate directly with your customers on WhatsApp, using Quoting24 as a bridge.

In simple terms, thanks to this integration, you can send messages and documents automatically, without having to open the Quoting24 application and without having to manually copy and paste data.


What can you do?

Using this connection, your management system can perform three main actions at once:

  1. Send a text message

You can write any information to the customer: a notice that goods are ready, an order confirmation or a simple greeting.

  1. Send files and documents (PDF, images, etc.)

Together with the text, you can attach files. This is very useful, for example, to send the PDF of a quote or an invoice directly in the customer's WhatsApp chat.

  1. Automatically close the request (Ticket)

Often, when a quote or confirmation is sent, the operation can be considered complete.

You can tell the system to "archive" (close) the conversation immediately after sending the message, so the list of open requests on Quoting24 stays clean without having to do it manually.


Technical details for integration

One endpoint is available to send messages to an individual contact through WhatsApp Business API.

Authentication is performed through the X-API-Key header using your tenant's API key, available in the account settings.


Send message to a contact

Endpoint: https://api.quoting24.com/webhook/sendmessage

Text message:

curl --request POST \
  --url https://api.quoting24.com/webhook/sendmessage \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <la-tua-api-key>' \
  --data '{
    "tenant_id": "<il-tuo-tenant-id>",
    "phone_number": "+39123456789",
    "channel": "whatsapp-api",
    "message_content": {
      "text": "Ciao! Il tuo preventivo e pronto."
    },
    "auto_close_ticket": true
  }'

Message with image or document (public URL):

curl --request POST \
  --url https://api.quoting24.com/webhook/sendmessage \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <la-tua-api-key>' \
  --data '{
    "tenant_id": "<il-tuo-tenant-id>",
    "phone_number": "+39123456789",
    "channel": "whatsapp-api",
    "message_content": {
      "type": "file",
      "text": "In allegato il tuo preventivo.",
      "file": {
        "url": "https://esempio.com/preventivo.pdf",
        "name": "preventivo.pdf",
        "mime_type": "application/pdf"
      }
    },
    "auto_close_ticket": true
  }'

message_content parameters:

Field Type Required Description
type text / image / video / audio / file No, default text Message type
text string No Message text or file caption
file.url URL string Yes if type is not text Public URL of the file to send
file.name string Yes if type is not text File name with extension, for example preventivo.pdf
file.mime_type string Yes if type is not text MIME type, for example application/pdf or image/jpeg

Main parameters:

Field Description
tenant_id Your tenant ID, available from settings
phone_number Customer phone number with international prefix, for example +39123456789
channel whatsapp-api for WhatsApp Business API
auto_close_ticket true to automatically close the ticket after sending

Note: the file to attach must be reachable through a public URL. If the file comes from management software or an internal system, make sure it is accessible from the internet before passing its link to the API.

Operational note: message sending follows Meta's rules. To start conversations outside the 24-hour customer service window, pre-approved templates may be required.