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
Pobierz aplikacje desktopowa
Pobierz i zainstaluj All-in-One Messenger Hub na swoim komputerze z systemem Windows.
Polacz swoje konto WhatsApp
Dodaj swoje konto WhatsApp do aplikacji, skanujac kod QR.
Stworz API sesji
Przejdz do zakladki WhatsApp i utworz nowe API sesji. Powiaz je ze swoim kanalem WhatsApp.
Skopiuj swoj klucz API
Skopiuj wygenerowany klucz API. Przechowuj go bezpiecznie - to Twoje uwierzytelnienie.
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 |
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"
}
}
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"
}
}
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.
Chatbot API
Wyzwalaj odpowiedzi chatbota i zarzadzaj konwersacjami programowo.
Contacts API
Uzyskuj dostep do kontaktow w komunikatorach i zarzadzaj nimi na wielu platformach.
Webhooki
Otrzymuj powiadomienia w czasie rzeczywistym, gdy wiadomosci sa odbierane lub wysylane.
All-in-One Messenger Hub