Typy połączeń

Każde połączenie zwraca pole provider, które przyjmuje jedną z dwóch wartości:

Oba typy wysyłają i odbierają wiadomości przez te same endpointy, z tymi samymi treściami żądań i tymi samymi dwoma identyfikatorami wiadomości. Jeśli zakładali Państwo, że połączenie QR z własnej aplikacji jest niemożliwe: jest możliwe.

Czym naprawdę się różnią

Webhooks. Zdarzenia są wysyłane tylko dla połączeń qr. Połączenia cloud_api nie wysyłają dziś żadnych webhooks — w ich przypadku należy odpytywać GET /messages i GET /connections/{id}.

Parowanie. POST /connections/{id}/pairing-code dotyczy wyłącznie qr. Numer cloud_api odpowiada 409 not_supported_for_provider; to odmowa trwała, więc nie należy ponawiać żądania.

Czas wysyłki. Wysyłka przez qr zwykle trwa 1–7 s (do ok. 20 s przy długim tekście), a w ścieżce samonaprawy może potrwać ok. 2,5 minuty. Wysyłka przez cloud_api trwa około 1 s. Limit czasu HTTP należy dobrać do wolniejszego przypadku: co najmniej 180 s.

Oznaczanie jako przeczytane. POST /messages/read oznacza cały czat w połączeniu qr. Połączenie cloud_api może oznaczyć tylko jedną konkretną wiadomość, dlatego żądanie zawierające wyłącznie phone automatycznie wskazuje Państwa ostatnią wiadomość przychodzącą z tego numeru.

Wolumen. Nowo sparowany numer qr ma przez 72 godziny limity rozgrzewkowe na liczbę wiadomości w ciągu godziny; przekroczenie limitu zwraca 429 warmup_limited. Zob. Licences & trial.

Stabilność sesji. Połączenie qr jest powiązane z telefonem, który musi pozostać osiągalny, więc może się rozłączyć i wymagać ponownego parowania — do tego służą connection.disconnected / connection.connected oraz flaga needs_reconnect. Połączenie cloud_api niczego nie skanuje i nie ma tego rodzaju awarii.