Scrivi su Whatsapp tramite le nostre API

Questa funzionalità permette al tuo gestionale o a qualsiasi altro software esterno di comunicare direttamente con i tuoi clienti su WhatsApp, utilizzando Quoting24 come ponte.

In parole semplici, grazie a questa integrazione è possibile inviare messaggi e documenti in modo automatico, senza dover aprire l'applicazione di Quoting24 e senza dover copiare e incollare manualmente i dati.

Cosa è possibile fare?

Utilizzando questa connessione, il tuo sistema gestionale può compiere tre azioni principali in un colpo solo:

Inviare un messaggio di testo

Puoi scrivere al cliente qualsiasi informazione: un avviso di merce pronta, una conferma d'ordine o un semplice saluto.

Inviare file e documenti (PDF, immagini, ecc.)

Insieme al testo, puoi allegare dei file. Molto utile, ad esempio, per inviare il PDF di un preventivo o di una fattura direttamente nella chat WhatsApp del cliente.

Chiudere automaticamente la richiesta (Ticket)

Spesso, quando si invia un preventivo o una conferma, l'operazione si può dire conclusa.

È possibile dire al sistema di "archiviare" (chiudere) subito la conversazione dopo l'invio del messaggio, così da tenere pulita la lista delle richieste aperte su Quoting24 senza doverlo fare a mano.

Dettagli tecnici per l'integrazione

È disponibile un endpoint per inviare messaggi a un contatto individuale tramite WhatsApp Business API.

L'autenticazione avviene tramite header X-API-Key usando la chiave API del tuo tenant, reperibile nelle impostazioni account.

Invia messaggio a un contatto

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

Messaggio di testo:

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 è pronto."
    },
    "auto_close_ticket": true
  }'

Messaggio con immagine o documento (URL pubblico):

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
  }'

Parametri message_content:

Campo	Tipo	Obbligatorio	Descrizione
`type`	`text` / `image` / `video` / `audio` / `file`	No, default `text`	Tipo di messaggio
`text`	stringa	No	Testo del messaggio o didascalia del file
`file.url`	stringa URL	Sì se `type` è diverso da `text`	URL pubblico del file da inviare
`file.name`	stringa	Sì se `type` è diverso da `text`	Nome del file con estensione, ad esempio `preventivo.pdf`
`file.mime_type`	stringa	Sì se `type` è diverso da `text`	Tipo MIME, ad esempio `application/pdf` o `image/jpeg`

Parametri principali:

Campo	Descrizione
`tenant_id`	ID del tuo tenant, disponibile dalle impostazioni
`phone_number`	Numero di telefono del cliente con prefisso internazionale, ad esempio `+39123456789`
`channel`	`whatsapp-api` per WhatsApp Business API
`auto_close_ticket`	`true` per chiudere automaticamente il ticket dopo l'invio

Nota: il file da allegare deve essere raggiungibile tramite un URL pubblico. Se il file proviene da un gestionale o da un sistema interno, assicurarsi che sia accessibile da internet prima di passarne il link all'API.

Nota operativa: l'invio dei messaggi segue le regole Meta. Per avviare conversazioni fuori dalla finestra di assistenza delle 24 ore possono essere necessari template pre-approvati.