Über unsere APIs auf WhatsApp schreiben

Diese Funktion ermöglicht es deinem ERP oder jeder anderen externen Software, direkt mit deinen Kunden über WhatsApp zu kommunizieren, wobei Quoting24 als Brücke dient.

Einfach ausgedrückt kannst du dank dieser Integration Nachrichten und Dokumente automatisch senden, ohne die Quoting24-Anwendung öffnen und ohne Daten manuell kopieren und einfügen zu müssen.

Was ist möglich?

Mit dieser Verbindung kann dein ERP-System drei Hauptaktionen auf einmal ausführen:

Eine Textnachricht senden

Du kannst dem Kunden beliebige Informationen schreiben: eine Benachrichtigung über bereitstehende Ware, eine Auftragsbestätigung oder einen einfachen Gruß.

Dateien und Dokumente senden (PDF, Bilder usw.)

Zusammen mit dem Text kannst du Dateien anhängen. Sehr nützlich zum Beispiel, um die PDF eines Angebots oder einer Rechnung direkt in den WhatsApp-Chat des Kunden zu senden.

Die Anfrage automatisch schließen (Ticket)

Oft kann ein Vorgang nach dem Senden eines Angebots oder einer Bestätigung als abgeschlossen gelten.

Du kannst dem System mitteilen, die Unterhaltung nach dem Senden der Nachricht sofort zu "archivieren" (zu schließen), damit die Liste der offenen Anfragen in Quoting24 sauber bleibt, ohne dies manuell tun zu müssen.

Technische Details für die Integration

Es ist ein Endpoint verfügbar, um Nachrichten an einen einzelnen Kontakt über WhatsApp Business API zu senden.

Die Authentifizierung erfolgt über den Header X-API-Key mit dem API-Schlüssel deines Tenants, der in den Kontoeinstellungen verfügbar ist.

Nachricht an einen Kontakt senden

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

Textnachricht:

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

Nachricht mit Bild oder Dokument (öffentliche 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
  }'

Parameter message_content:

Feld	Typ	Erforderlich	Beschreibung
`type`	`text` / `image` / `video` / `audio` / `file`	Nein, Standard `text`	Nachrichtentyp
`text`	Zeichenkette	Nein	Nachrichtentext oder Dateibeschriftung
`file.url`	URL-Zeichenkette	Ja, wenn `type` nicht `text` ist	Öffentliche URL der zu sendenden Datei
`file.name`	Zeichenkette	Ja, wenn `type` nicht `text` ist	Dateiname mit Erweiterung, zum Beispiel `preventivo.pdf`
`file.mime_type`	Zeichenkette	Ja, wenn `type` nicht `text` ist	MIME-Typ, zum Beispiel `application/pdf` oder `image/jpeg`

Hauptparameter:

Feld	Beschreibung
`tenant_id`	ID deines Tenants, verfügbar in den Einstellungen
`phone_number`	Telefonnummer des Kunden mit internationaler Vorwahl, zum Beispiel `+39123456789`
`channel`	`whatsapp-api` für WhatsApp Business API
`auto_close_ticket`	`true`, um das Ticket nach dem Senden automatisch zu schließen

Hinweis: Die anzuhängende Datei muss über eine öffentliche URL erreichbar sein. Wenn die Datei aus einem ERP oder einem internen System stammt, stelle sicher, dass sie über das Internet zugänglich ist, bevor du den Link an die API übergibst.

Operativer Hinweis: Der Versand von Nachrichten folgt den Regeln von Meta. Um Unterhaltungen außerhalb des 24-Stunden-Servicefensters zu starten, können vorab genehmigte Templates erforderlich sein.