Udostępnij za pośrednictwem


Połączenie bota do Serwisu Facebook

Możesz skonfigurować bota tak, aby komunikował się z osobami za pośrednictwem aplikacji Facebook Messenger lub Facebook Workplace. W tym artykule opisano, jak utworzyć aplikację serwisu Facebook przy użyciu witryny Meta for Developers, połączyć bota z aplikacją serwisu Facebook na platformie Azure i przetestować bota na Facebooku.

W tym artykule pokazano, jak dodać kanał Facebook do bota za pośrednictwem witryny Azure Portal. Aby uzyskać informacje na temat używania niestandardowej karty kanału, zobacz Dodatkowe informacje.

Wymagania wstępne

  • Subskrypcja platformy Azure. Jeśli jeszcze go nie masz, przed rozpoczęciem utwórz bezpłatne konto .
  • Bot opublikowany na platformie Azure, z którym chcesz nawiązać połączenie z serwisem Facebook.
  • Konto usługi Facebook for Developers. Jeśli nie masz konta, możesz go utworzyć w developers.facebook.com.
  • Strona serwisu Facebook, na której użytkownicy będą uzyskiwać dostęp do bota. Jeśli jeszcze jej nie masz, utwórz nową stronę.
  • Aby korzystać z aplikacji Facebook Workplace z botem, musisz utworzyć konto w miejscu pracy i niestandardową integrację, aby połączyć bota z.

Tworzenie aplikacji z serwisu Facebook

Użytkownicy będą uzyskiwać dostęp do bota ze strony serwisu Facebook. Aby połączyć bota, włączysz aplikację Facebook Messenger na stronie serwisu Facebook, a następnie połączysz bota ze stroną.

Tworzenie aplikacji

  1. Zaloguj się do konta meta for Developers .
  2. Przejdź do pozycji Utwórz nową aplikację w serwisie Facebook.
  3. Na stronie Wybierz typ aplikacji wybierz pozycję Biznes , a następnie pozycję Dalej.
  4. Na stronie Podaj podstawowe informacje wprowadź nazwę aplikacji i wybierz pozycję Utwórz aplikację.
    • Jeśli zostanie wyświetlony monit, wprowadź hasło i wybierz pozycję Prześlij , aby utworzyć aplikację.
    • Po utworzeniu aplikacji witryna przechodzi do strony aplikacji.
  5. Rozwiń Ustawienia i wybierz pozycję Podstawowa.
    1. Skopiuj i zapisz identyfikator aplikacji i klucz tajny aplikacji.
  6. Teraz w obszarze Ustawienia wybierz pozycję Zaawansowane.
    1. W wynikowym okienku przewiń w dół do ustawień zabezpieczeń i włącz opcję Zezwalaj na dostęp do interfejsu API do ustawień aplikacji.
    2. Wybierz Zapisz zmiany.

Włącz program Messenger

  1. Wybierz pozycję Pulpit nawigacyjny.
  2. W wynikowym okienku przewiń w dół do kafelka Messenger i wybierz pozycję Skonfiguruj.
  3. Witryna dodaje ustawienia messengera do aplikacji i wyświetla stronę ustawień.

Dodawanie stron i generowanie tokenów

  1. W obszarze Messenger wybierz pozycję Ustawienia.

  2. Przewiń w dół do pozycji Tokeny dostępu i wybierz pozycję Dodaj lub Usuń strony.

    1. Po wyświetleniu monitu o skojarzenie tożsamości z Messengerem kontynuuj korzystanie z bieżącego konta lub zaloguj się do innego.
    2. Po wyświetleniu monitu o strony, których chcesz używać z aplikacją, wybierz strony, a następnie wybierz pozycję Dalej.
    3. Jeśli zostanie wyświetlony monit o przesłanie żądania przeglądu logowania, przejrzyj informacje i wybierz pozycję Gotowe.
    4. Po pomyślnym wyświetleniu strony powodzenia w witrynie. Naciśnij OK, aby kontynuować.
  3. Strona, która została dodana, zostanie wyświetlona na liście Strony .

    Skopiuj i zapisz identyfikator strony do późniejszego użycia.

  4. Wybierz pozycję Generuj token dla strony.

    1. Witryna wyświetla informacje o zabezpieczeniach i daje możliwość skopiowania tokenu.
    2. Przeczytaj i potwierdź ostrzeżenie.
    3. Skopiuj token i wybierz pozycję Gotowe.

Masz teraz informacje o aplikacji i token dla następnego kroku. Pozostaw oczekujące kroki ustawień serwisu Facebook. Zaktualizujesz je później.

Konfigurowanie bota na platformie Azure

Aby umożliwić botowi wysyłanie wiadomości i innych zdarzeń do aplikacji Facebook Messenger, włącz integrację elementów webhook.

  1. W nowym oknie przeglądarki przejdź do witryny Azure Portal.
  2. Otwórz blok zasobów usługi Azure Bot dla bota.
  3. Otwórz kanały i wybierz pozycję Facebook.
  4. W obszarze Konfigurowanie kanału serwisu Facebook wprowadź informacje skopiowane w poprzednich krokach.
    1. Wprowadź identyfikator aplikacji w serwisie Facebook i wpis tajny aplikacji facebook.
    2. Wprowadź identyfikator strony i token dostępu.
    3. Skopiuj wygenerowany adres URL wywołania zwrotnego i sprawdź wartości tokenu .
    4. Wybierz pozycję Dodaj.

Napiwek

  • Jeśli nie masz kopii informacji z poprzednich kroków, możesz pobrać je dla witryny Meta for Developers.
  • Jeśli chcesz, utwórz nowy token internetowy dla strony. Aby uzyskać instrukcje, zobacz Dodawanie stron i generowanie tokenów.

Włączanie elementów webhook

Wróć do ustawień serwisu Facebook, aby zakończyć proces konfiguracji.

  1. W witrynie Meta for Developers wróć do strony ustawień programu Messenger dla aplikacji.
  2. W wynikowym okienku przewiń w dół do sekcji Elementy webhook i wybierz pozycję Dodaj adres URL wywołania zwrotnego.
  3. Na stronie Edytowanie adresu URL wywołania zwrotnego:
    1. Wprowadź adres URL wywołania zwrotnego i sprawdź wartości tokenu skopiowane z witryny Azure Portal.
    2. Wybierz pozycję Weryfikuj i zapisz.
  4. Strona, którą dodano, jest teraz wyświetlana na liście Strony w obszarze Elementy webhook.
  5. Wybierz pozycję Dodaj subskrypcje dla strony.
    1. Na stronie Edytowanie subskrypcji strony wybierz następujące pola subskrypcji:
      • wiadomości
      • messaging_postbacks
      • messaging_options
      • message_deliveries
    2. Wybierz pozycję Zapisz.
  6. W witrynie zostaną wyświetlone pola dodane subskrypcji obok strony bota.

Upublicznij aplikację

Dopóki aplikacja nie zostanie opublikowana, będzie ona dostępna w trybie programowania. Funkcje wtyczek i interfejsów API będą działać tylko dla administratorów, deweloperów i testerów.

Tylko twórca (konto deweloperskie w serwisie Facebook, które utworzyło stronę i bota), może uzyskać odpowiedź bota. Normalni użytkownicy serwisu Facebook nie widzą strony ani bota. Przypisz role deweloperskie lub testowe użytkownikom docelowym, aby mogli również rozmawiać z botem.

Użytkownicy, którzy mają zostać dodani do ról testera, muszą najpierw zarejestrować się w witrynie Meta for Developers. Rola testera nie jest dostępna dla użytkowników serwisu Facebook, którzy nie mają konta Meta for Developers. Aby uzyskać więcej informacji na temat ról aplikacji i użytkowników testowych, zobacz dokumentację dla deweloperów meta for Developers.

Prześlij do przeglądu

Facebook wymaga adresu URL zasad ochrony prywatności i adresu URL warunków użytkowania usługi na swojej podstawowej stronie ustawień aplikacji. Strona Kodeksu postępowania zawiera linki do zasobów innych firm, które ułatwiają tworzenie zasad ochrony prywatności. Strona Warunki użytkowania zawiera przykładowe terminy ułatwiające utworzenie odpowiedniego dokumentu dotyczącego warunków użytkowania usługi.

Po zakończeniu bota facebook ma własny proces przeglądu aplikacji publikowanych w Messengerze. Bot zostanie przetestowany, aby upewnić się, że jest on zgodny z zasadami platformy facebooka.

Upublicznij aplikację i opublikuj stronę

Po pomyślnym zakończeniu przeglądu na pulpicie nawigacyjnym aplikacji w obszarze Przegląd aplikacji ustaw dla aplikacji wartość Publiczna. Upewnij się, że strona serwisu Facebook skojarzona z tym botem została opublikowana. Stan jest wyświetlany w ustawieniach stron.

Ustawianie wersji interfejsu API

Jeśli otrzymasz powiadomienie od Facebooka o wycofaniu określonej wersji interfejsu API programu Graph:

  1. Przejdź do witryny Meta dla deweloperów.
  2. Przejdź do aplikacji utworzonej dla bota.
  3. W obszarze Ustawienia wybierz pozycję Zaawansowane.
  4. Wybierz pozycję Uaktualnij wersję interfejsu API, a następnie przełącz opcję Uaktualnij wszystkie wywołania do wersji 4.0.

Przetestuj połączenie, wykonując kroki opisane w sekcji Testowanie bota w serwisie Facebook .

Testowanie bota w serwisie Facebook

Teraz możesz sprawdzić, czy bot jest poprawnie połączony z Serwisem Facebook, wysyłając wiadomość za pośrednictwem strony serwisu Facebook skojarzonej z nową aplikacją na Facebooku.

  1. Przejdź do serwisu Facebook i przejdź do profilu swojej strony.
  2. Wybierz pozycję Więcej akcji (...), a następnie przycisk Dodaj akcję.
    1. W oknie dialogowym Dostosowywanie akcji wybierz pozycję Wypróbuj i postępuj zgodnie z instrukcjami.
    2. Na stronie Przycisk akcji w obszarze Pobierz osoby do kontaktu wybierz pozycję Wyślij wiadomość.
    3. Wybierz pozycję Dalej, ukończ okno dialogowe i zapisz zmiany.
  3. Wróć do swojego profilu osobistego.
  4. Przejdź do strony i wybierz pozycję Komunikat , aby przetestować połączenie z botem.

Możesz również przetestować tę funkcję przy użyciu przykładowego bota dla karty Facebook, wypełniając plik appsettings.json tymi samymi wartościami opisanymi w poprzednich krokach.

Dodatkowe informacje

Zobacz przykład Bot Framework C# Facebook-events , aby zapoznać się z przykładowym botem obsługującym komunikację z usługą Facebook Messenger.

Aby uzyskać dokumentację aplikacji Facebook Messenger, zobacz:

Aby zapoznać się z dokumentacją aplikacji Facebook Workplace, zobacz: