Narzędzia uczniów — kanały — Twilio

Wysyłaj wiadomości SMS i WhatsApp lub Disciple.Tools powiadomienia przy użyciu Twilio.

Wymagania wstępne

A Konto Twilio skonfiguruj za pomocą numeru telefonu i usługa przesyłania wiadomości Ustawiać.

Aby korzystać z WhatsApp, potrzebujesz Nadawca Whatsappa powiązane z jednym z numerów telefonów Twilio.

Zobacz instrukcje konfiguracji w wiki.

Zrobi

• Pozwól innym wtyczkom (programowi planującemu link magic link) wysyłać wiadomości za pomocą Twilio.
• Opcjonalnie: Skonfiguruj powiadomienia DT, które mają być wysyłane SMS-em lub WhatsApp.
• Udostępnia interfejs API do bezpośredniego wysyłania wiadomości.

Wykorzystanie API

Wtyczkę Disciple Tools - Kanały - Twilio można odłączyć, aby działała niezależnie od wtyczki Disciple Tools - Magic Links; w celu bezpośredniego wysyłania wiadomości.

//check if twilio is setup and configured
dt_twilio_configured()

Wyślij jako SMS na numer. Zwraca wartość logiczną wskazującą, czy wiadomość została pomyślnie wysłana.

Disciple_Tools_Twilio_API::send_sms( $phone_number, $message );

Wyślij jako wiadomość WhatsApp na numer. Uwaga: to zadziała tylko wtedy, gdy kontakt wysłał Ci wiadomość WhatsApp w ciągu ostatnich 24 godzin. Zwraca wartość logiczną wskazującą, czy wiadomość została pomyślnie wysłana.

Disciple_Tools_Twilio_API::send_whatsapp( $phone_number, $message );

Wyślij wiadomość do użytkownika DT

$bool_result = dt_twilio_direct_send( 12, 'wp_user', $msg, [ 'service' => 'sms' ] );

Wyślij wiadomość do kontaktu DT

$bool_result = dt_twilio_direct_send( 343, 'post', $msg, [ 'service' => 'sms' ] );

• id: Przypisany identyfikator użytkownika WP lub identyfikator postu, w zależności od wartości typu.
• rodzaj: Rodzaj systemu; który musi być jednym z następujących:
  • wp_użytkownik
  • pisać
• wiadomość: Rzeczywista wiadomość do wysłania; który musi być zgodny ze wstępnie zdefiniowanym kształtem szablonu wiadomości Twilio. Na przykład:

  Hi, Please update records -> {{link}} -> Link will expire on {{time}}

  • {{...}} symbole zastępcze, które należy zastąpić rzeczywistymi wartościami.
• argumenty: Możliwość określenia zastąpienia opcji podczas wysyłania. Obecnie obsługiwane są następujące zastąpienia:
  • usługa: Określ, które z następujących typów usług Twilio mają zostać przyjęte:
    • sms
    • whatsapp

Wkład

Składki mile widziane. Możesz zgłaszać problemy i błędy w Zagadnienia część repozytorium. Możesz prezentować pomysły w formacie Dyskusje część repozytorium. Mile widziane są wkłady w kod za pomocą Prośba o pociągnięcie system dla gita. Aby uzyskać więcej informacji na temat wkładu, zobacz wytyczne dotyczące składek.