Status da compilação

Ferramentas para discípulos - Canais - Twilio

Envie mensagens SMS e WhatsApp ou Disciple.Tools notificações usando Twilio.

Pré-requisitos

A Conta Twilio configurar com um número de telefone e serviço de mensagens configuração.

Para usar o WhatsApp você precisará de um Remetente do Whatsapp vinculado a um dos seus números de telefone twilio.

Consulte as instruções de configuração no wiki.

Vai fazer

  • Deixe outros plug-ins (agendador de links mágicos) enviarem mensagens usando o Twilio.
  • Opcionalmente: Configure notificações DT para serem enviadas por SMS ou WhatsApp.
  • Fornece uma API para enviar mensagens diretamente.

Uso de API

O plugin Disciple Tools - Channels - Twilio pode ser desacoplado, para funcionar de forma independente do plugin Disciple Tools - Magic Links; para enviar mensagens diretamente.

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

Envie como sms para um número. Retorna um valor booleano que indica se a mensagem foi enviada com sucesso.

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

Envie como mensagem do WhatsApp para um número. Observação: isso só funcionará se o contato tiver enviado mensagens do WhatsApp para você nas últimas 24 horas. Retorna um valor booleano que indica se a mensagem foi enviada com sucesso.

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

Envie uma mensagem para um usuário DT

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

Envie uma mensagem para um contato da DT

$bool_result = dt_twilio_direct_send( 343, 'post', $msg, [ 'service' => 'sms' ] );
  • ID: ID de usuário WP ou ID de postagem atribuído, dependendo do valor do tipo.
  • Tipo: Tipo de sistema; que deve ser um dos seguintes:
    • wp_user
    • postar
  • mensagem: Mensagem real a ser enviada; que deve aderir ao formato predefinido do modelo de mensagem Twilio. Por exemplo:
    Hi, Please update records -> {{link}} -> Link will expire on {{time}}
    • {{...}} espaços reservados a serem substituídos por valores reais.
  • argumentos: Capacidade de especificar substituições de opções durante o envio. Atualmente, as seguintes substituições são suportadas:
    • serviço: Especifique quais dos seguintes tipos de serviço twilio serão adotados:
      • sms
      • whatsapp

Contribuição

Contribuições são bem-vindas. Você pode relatar problemas e bugs no Questões seção do repositório. Você pode apresentar ideias no discussões seção do repositório. E contribuições de código são bem-vindas usando o Solicitação de pull sistema para git. Para mais detalhes sobre a contribuição, consulte o diretrizes de contribuição.