Pisz na WhatsApp przez nasze API

Ta funkcja pozwala Twojemu systemowi ERP lub dowolnemu innemu zewnętrznemu oprogramowaniu komunikować się bezpośrednio z Twoimi klientami na WhatsApp, używając Quoting24 jako pomostu.

Mówiąc prosto, dzięki tej integracji można wysyłać wiadomości i dokumenty automatycznie, bez otwierania aplikacji Quoting24 i bez ręcznego kopiowania oraz wklejania danych.

Co można zrobić?

Korzystając z tego połączenia, Twój system ERP może wykonać trzy główne akcje za jednym razem:

Wysłać wiadomość tekstową

Możesz napisać do klienta dowolną informację: powiadomienie o gotowym towarze, potwierdzenie zamówienia albo zwykłe powitanie.

Wysłać pliki i dokumenty (PDF, obrazy itd.)

Razem z tekstem możesz załączyć pliki. Jest to bardzo przydatne na przykład do wysłania PDF wyceny lub faktury bezpośrednio w czacie WhatsApp klienta.

Automatycznie zamknąć zapytanie (Ticket)

Często po wysłaniu wyceny lub potwierdzenia operację można uznać za zakończoną.

Można polecić systemowi, aby od razu "zarchiwizował" (zamknął) rozmowę po wysłaniu wiadomości, utrzymując czystą listę otwartych zapytań w Quoting24 bez ręcznego działania.

Szczegóły techniczne integracji

Dostępny jest jeden endpoint do wysyłania wiadomości do pojedynczego kontaktu przez WhatsApp Business API.

Uwierzytelnianie odbywa się przez header X-API-Key przy użyciu klucza API Twojego tenanta, dostępnego w ustawieniach konta.

Wyślij wiadomość do kontaktu

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

Wiadomość tekstowa:

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

Wiadomość z obrazem lub dokumentem (publiczny 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
  }'

Parametry message_content:

Pole	Typ	Obowiązkowe	Opis
`type`	`text` / `image` / `video` / `audio` / `file`	Nie, domyślnie `text`	Typ wiadomości
`text`	string	Nie	Tekst wiadomości lub podpis pliku
`file.url`	string URL	Tak, jeśli `type` różni się od `text`	Publiczny URL pliku do wysłania
`file.name`	string	Tak, jeśli `type` różni się od `text`	Nazwa pliku z rozszerzeniem, na przykład `preventivo.pdf`
`file.mime_type`	string	Tak, jeśli `type` różni się od `text`	Typ MIME, na przykład `application/pdf` lub `image/jpeg`

Główne parametry:

Pole	Opis
`tenant_id`	ID Twojego tenanta, dostępne w ustawieniach
`phone_number`	Numer telefonu klienta z prefiksem międzynarodowym, na przykład `+39123456789`
`channel`	`whatsapp-api` dla WhatsApp Business API
`auto_close_ticket`	`true`, aby automatycznie zamknąć ticket po wysłaniu

Uwaga: plik do załączenia musi być dostępny przez publiczny URL. Jeśli plik pochodzi z systemu ERP lub systemu wewnętrznego, upewnij się, że jest dostępny z internetu, zanim przekażesz jego link do API.

Uwaga operacyjna: wysyłanie wiadomości podlega regułom Meta. Aby rozpocząć rozmowy poza 24-godzinnym oknem obsługi, mogą być wymagane wstępnie zatwierdzone szablony.