RichPear HOME DOCS Začít

Integrace RichPear Home

Facebook Messenger

Facebook Messenger slouží jako notifikační kanál přes Facebook stránku a aplikaci. RichPear Home odešle zprávu jménem stránky na zadaného příjemce.

Začít nastaveníZpět na integrace
Doména
facebook
Typ
Notifikace
Komunikace
cloudové odesílání
Nastavení
ruční konfigurace
UI

Screenshoty z RichPear Home

Snímky ukazují dostupný a bezpečný krok v českém rozhraní RichPear Home pro tuto integraci.

Vyhledání položky Facebook Messenger v českém rozhraní RichPear Home.
První bezpečný krok nastavení integrace Facebook Messenger v RichPear Home.
01

Co integrace přidá

Integrace vytvoří notifikační službu notify.NOTIFIER_NAME. Vyžaduje token stránky a správně nastavenou Facebook aplikaci.

Výsledek v systému

  1. odesílání textových notifikací přes Messenger
  2. možnost mít více notifikačních kanálů s různými názvy
  3. podpora bohatších zpráv podle možností Messenger platformy
02

Příprava před přidáním

RichPear Home se v domácí síti běžně otevírá na http://rphome.local:8123. Pokud tato adresa neodpoví, použijte http://IP-ADRESA:8123.

Než začnete

  1. Vytvořte nebo použijte Facebook stránku, ze které se budou zprávy odesílat.
  2. V Meta prostředí připravte aplikaci s Messenger oprávněními a page access tokenem.
  3. Příjemce musí být dostupný pro vaši aplikaci; u neschválené aplikace typicky jen administrátor, vývojář nebo tester.
03

Nastavení v RichPear Home

Do configuration.yaml přidejte notifikační platformu s page access tokenem. Volba name určí název služby, například notify.messenger.

notify:
  - name: messenger
    platform: facebook
    page_access_token: FACEBOOK_PAGE_ACCESS_TOKEN
U účtů, tokenů a hesel používejte samostatný servisní účet, kde to služba dovolí. U lokálních zařízení nastavte stabilní IP adresu nebo spolehlivé jméno v síti.
04

Kontrola po přidání

Po dokončení nastavení otevřete detail integrace, zkontrolujte vytvořená zařízení a entity, pojmenujte je česky a přiřaďte je do oblastí.

Ověřte hlavně

  1. v Nástrojích pro vývojáře zavolejte notifikační akci a pošlete krátkou zkušební zprávu
  2. ověřte formát cíle podle typu příjemce a nastavení Messenger aplikace
  3. pokud používáte více notifikátorů, kontrolujte správný název služby
05

Řešení problémů

Když integrace nefunguje podle očekávání, otevřete Nastavení -> Systém -> Logy a hledejte chyby podle domény facebook. Integraci neodstraňujte jako první krok; nejdřív ověřte přístup, síť, podporovaný model a poslední úspěšnou aktualizaci.

Typické kontroly

  1. neplatný nebo expirovaný page access token způsobí odmítnutí zprávy
  2. neschválená aplikace obvykle nedoručuje běžným uživatelům mimo role aplikace
  3. telefonní číslo příjemce musí být ve správném mezinárodním formátu, pokud ho používáte jako target