Écrire sur WhatsApp via nos API

Cette fonctionnalité permet à votre logiciel de gestion ou à tout autre logiciel externe de communiquer directement avec vos clients sur WhatsApp, en utilisant Quoting24 comme passerelle.

En termes simples, grâce à cette intégration, il est possible d'envoyer des messages et documents de manière automatique, sans devoir ouvrir l'application Quoting24 et sans devoir copier-coller manuellement les données.

Que peut-on faire ?

En utilisant cette connexion, votre système de gestion peut effectuer trois actions principales en une seule fois :

Envoyer un message texte

Vous pouvez écrire au client n'importe quelle information : un avis de marchandise prête, une confirmation de commande ou une simple salutation.

Envoyer des fichiers et documents (PDF, images, etc.)

Avec le texte, vous pouvez joindre des fichiers. C'est très utile, par exemple, pour envoyer le PDF d'un devis ou d'une facture directement dans le chat WhatsApp du client.

Fermer automatiquement la demande (ticket)

Souvent, lorsqu'un devis ou une confirmation est envoyé, l'opération peut être considérée comme terminée.

Il est possible d'indiquer au système d'« archiver » (fermer) immédiatement la conversation après l'envoi du message, afin de garder propre la liste des demandes ouvertes sur Quoting24 sans devoir le faire manuellement.

Détails techniques pour l'intégration

Un endpoint est disponible pour envoyer des messages à un contact individuel via WhatsApp Business API.

L'authentification se fait via l'en-tête X-API-Key en utilisant la clé API de votre tenant, disponible dans les paramètres du compte.

Envoyer un message à un contact

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

Message texte :

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

Message avec image ou document (URL public) :

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

Paramètres message_content :

Champ	Type	Obligatoire	Description
`type`	`text` / `image` / `video` / `audio` / `file`	Non, par défaut `text`	Type de message
`text`	chaîne	Non	Texte du message ou légende du fichier
`file.url`	chaîne URL	Oui si `type` est différent de `text`	URL publique du fichier à envoyer
`file.name`	chaîne	Oui si `type` est différent de `text`	Nom du fichier avec extension, par exemple `preventivo.pdf`
`file.mime_type`	chaîne	Oui si `type` est différent de `text`	Type MIME, par exemple `application/pdf` ou `image/jpeg`

Paramètres principaux :

Champ	Description
`tenant_id`	ID de votre tenant, disponible dans les paramètres
`phone_number`	Numéro de téléphone du client avec indicatif international, par exemple `+39123456789`
`channel`	`whatsapp-api` pour WhatsApp Business API
`auto_close_ticket`	`true` pour fermer automatiquement le ticket après l'envoi

Note : le fichier à joindre doit être accessible via une URL publique. Si le fichier provient d'un logiciel de gestion ou d'un système interne, assurez-vous qu'il est accessible depuis internet avant de transmettre son lien à l'API.

Note opérationnelle : l'envoi des messages suit les règles Meta. Pour ouvrir une conversation en dehors de la fenêtre d'assistance de 24 heures, des modèles préapprouvés peuvent être nécessaires.