Przewodnik po integracji z API

Polacz swoj CRM, system rezerwacji lub dowolna aplikacje, aby wysylac wiadomosci WhatsApp przez nasze proste API.

Zacznij w 5 prostych krokach

1

Pobierz aplikacje desktopowa

Pobierz i zainstaluj All-in-One Messenger Hub na swoim komputerze z systemem Windows.

2

Polacz swoje konto WhatsApp

Dodaj swoje konto WhatsApp do aplikacji, skanujac kod QR.

3

Stworz API sesji

Przejdz do zakladki WhatsApp i utworz nowe API sesji. Powiaz je ze swoim kanalem WhatsApp.

4

Skopiuj swoj klucz API

Skopiuj wygenerowany klucz API. Przechowuj go bezpiecznie - to Twoje uwierzytelnienie.

5

Zacznij wysylac wiadomosci

Uzywaj API ze swojej aplikacji. Pozostaw aplikacje desktopowa uruchomiona, aby dostarczac wiadomosci.

Uwierzytelnianie

Wszystkie punkty koncowe API wymagaja uwierzytelnienia za pomoca Twojego klucza API. Klucz mozesz przekazac na dowolny z tych sposobow:

Metoda Przyklad
Naglowek X-API-Key (zalecane) X-API-Key: your-api-key
Parametr zapytania/treci key=your-api-key
Parametr alternatywny api_key=your-api-key
POST

Wyslij wiadomosc

Wyslij wiadomosc WhatsApp na numer telefonu lub do grupy. Wiadomosci sa kolejkowane i dostarczane, gdy aplikacja desktopowa jest uruchomiona.

POST https://onemessengerhub.com/api/whatsapp-session/send

Parametry

Parametr Typ Wymagany Opis
key string Tak Twoj klucz API z aplikacji desktopowej
mobile string Warunkowy Numer telefonu z numerem kierunkowym kraju (wymagany, gdy nie podano group_id)
group_id string Warunkowy Identyfikator grupy WhatsApp (wymagany, gdy nie podano mobile). Sufiks @g.us jest dodawany automatycznie.
message string Tak Tresc wiadomosci (maks. 4096 znakow)

Przykladowe zadanie

curl -X POST https://onemessengerhub.com/api/whatsapp-session/send \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mobile": "1234567890", "message": "Hello!"}'

Proste zadanie GET (przegladarka lub link)

https://onemessengerhub.com/api/whatsapp-session/send?key=YOUR_API_KEY&mobile=1234567890&message=Hello!

Odpowiedz sukcesu (201)

{
  "success": true,
  "message": "Message queued successfully",
  "data": {
    "message_id": 123,
    "recipient": "1234567890",
    "status": "pending"
  }
}
POST

Zapisz kontakt

Zapisz lub zmien nazwe kontaktu w swoim WhatsApp. Operacja jest kolejkowana i przetwarzana przez aplikacje desktopowa.

POST https://onemessengerhub.com/api/whatsapp-session/save-contact

Parametry

Parametr Typ Wymagany Opis
key string Tak Twoj klucz API z aplikacji desktopowej
contact_id string Tak Numer telefonu kontaktu lub identyfikator WhatsApp (maks. 50 znakow). Sufiks @c.us jest dodawany automatycznie.
name string Tak Wyswietlana nazwa kontaktu (maks. 255 znakow)

Przykladowe zadanie

curl -X POST https://onemessengerhub.com/api/whatsapp-session/save-contact \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contact_id": "1234567890", "name": "John Doe"}'

Odpowiedz sukcesu (201)

{
  "success": true,
  "message": "Contact save operation queued",
  "data": {
    "operation_id": 456,
    "contact_id": "[email protected]",
    "status": "pending"
  }
}
POST

Usun kontakt

Usun kontakt ze swojego WhatsApp. Operacja jest kolejkowana i przetwarzana przez aplikacje desktopowa.

POST https://onemessengerhub.com/api/whatsapp-session/remove-contact

Parametry

Parametr Typ Wymagany Opis
key string Tak Twoj klucz API z aplikacji desktopowej
contact_id string Tak Numer telefonu kontaktu lub identyfikator WhatsApp (maks. 50 znakow). Sufiks @c.us jest dodawany automatycznie.

Przykladowe zadanie

curl -X POST https://onemessengerhub.com/api/whatsapp-session/remove-contact \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"contact_id": "1234567890"}'

Odpowiedz sukcesu (201)

{
  "success": true,
  "message": "Contact remove operation queued",
  "data": {
    "operation_id": 789,
    "contact_id": "[email protected]",
    "status": "pending"
  }
}

Obsluga bledow

API uzywa standardowych kodow statusu HTTP. Oto najczestsze odpowiedzi z bledami:

Blad uwierzytelniania (401)

{
  "success": false,
  "message": "Invalid or inactive API key"
}

Blad walidacji (422)

{
  "success": false,
  "message": "Validation failed",
  "errors": {
    "mobile": ["The mobile field is required when group id is not present."],
    "message": ["The message field is required."]
  }
}

Co mozesz zbudowac

Integracja z CRM

Wysylaj wiadomosci nastepcze, przypomnienia i aktualizacje bezposrednio ze swojego systemu CRM.

Potwierdzenia rezerwacji

Automatycznie wysylaj klientom potwierdzenia wizyt i przypomnienia.

Powiadomienia o zamowieniach

Informuj klientow o statusie zamowienia, aktualizacjach wysylki i danych dostawy.

Systemy alertow

Wysylaj wazne alerty i powiadomienia do swojego zespolu lub klientow.

Kampanie marketingowe

Wysylaj wiadomosci promocyjne i aktualizacje do swojej listy kontaktow.

Niestandardowe przeplywy pracy

Integruj z Zapier, Make, n8n lub dowolna platforma automatyzacji.

Wkrotce wiecej API

Rozwijamy nasza oferte API, aby obejmowala wiecej platform i zastosowan.

Wkrotce

Chatbot API

Wyzwalaj odpowiedzi chatbota i zarzadzaj konwersacjami programowo.

Wkrotce

Contacts API

Uzyskuj dostep do kontaktow w komunikatorach i zarzadzaj nimi na wielu platformach.

Wkrotce

Webhooki

Otrzymuj powiadomienia w czasie rzeczywistym, gdy wiadomosci sa odbierane lub wysylane.