Wysyłanie szablonu ze zmiennymi

Jak dopasowywane są parametry

Według pozycji, a nie nazwy. Pierwszy parametr na liście treści wypełnia pierwszy placeholder, drugi wypełnia drugi i tak dalej. Nie da się nadać zmiennej nazwy, a zamiana dwóch parametrów miejscami powoduje pomyślne wysłanie wiadomości z wartościami w niewłaściwych miejscach.

To niebezpieczny przypadek, ponieważ nic nie kończy się błędem. Klient otrzymuje potwierdzenie zamówienia z datą w miejscu kwoty, a nigdzie nie zostaje zapisany żaden błąd.

Komponenty mają osobne listy

Zmienna nagłówka i zmienna treści nie korzystają z jednej listy. Każdy komponent ma własne parametry, a ich połączenie powoduje niezgodność liczby parametrów.

• Parametry nagłówka trafiają do komponentu nagłówka, którego może być najwyżej jeden.
• Parametry treści trafiają kolejno do komponentu treści.
• Parametry URL przycisków trafiają do komponentu przycisku i są przypisane według numeru przycisku.
• Wysłanie jednej płaskiej listy dla wszystkich komponentów zwraca błąd 132000.

Jak poprawnie ustawić język

Szablon jest identyfikowany jednocześnie przez nazwę i język, więc ta sama nazwa w dwóch językach oznacza dwa szablony. Wysłanie en, gdy szablon utworzono jako en_US, nie uruchamia wartości domyślnej, lecz kończy się błędem 132001, który wygląda jak informacja, że szablon nie istnieje.

Wyświetl szablony dla numeru i skopiuj dokładny ciąg języka, zamiast zakładać jego format. To najczęstszy błąd szablonu i zarazem najmniej opisowy.

Parametry typowane

Większość parametrów to zwykły tekst. Niektóre mają jednak inny typ, a wysłanie ich jako tekstu kończy się błędem 132012.

• Parametry walutowe zawierają kwotę, kod waluty i tekst zastępczy.
• Parametry daty i czasu zawierają obiekt strukturalny z wartością zastępczą.
• Parametry multimedialne nagłówka zawierają media id lub link, a nie nazwę pliku.
• Tekst zastępczy jest wyświetlany, gdy aplikacja odbiorcy nie potrafi sformatować wartości.

Co oznacza poszczególny błąd

Te trzy błędy można rozróżnić, co znacznie ogranicza zgadywanie, jeśli zapisujesz je osobno, zamiast grupować jako błąd szablonu.

Błąd 132001 oznacza, że para nazwy i języka nie została rozpoznana, więc najpierw sprawdź język. Błąd 132000 oznacza nieprawidłową liczbę parametrów, więc porównaj ją z definicją szablonu. Błąd 132012 oznacza nieprawidłowy format wartości, zwykle dlatego, że parametr typowany wysłano jako zwykły ciąg tekstu.

Typowe błędy

• Zakładanie, że en zostanie zastąpione przez en_US. Tak się nie dzieje, a błąd wygląda jak brak szablonu.
• Łączenie parametrów nagłówka i treści w jedną listę. To osobne komponenty.
• Wysyłanie waluty lub daty jako zwykłego tekstu. Parametry typowane mają określoną strukturę.

Najczęściej zadawane pytania

Czytaj dalej