État de la construction

Outils pour les disciples - Canaux - Twilio

Envoyez des messages SMS et WhatsApp ou Disciple.Tools notifications à l'aide de Twilio.

Conditions préalables

A Compte Twilio configuration avec un numéro de téléphone et service de messagerie installer.

Pour utiliser WhatsApp, vous aurez besoin d'un Expéditeur WhatsApp lié à l'un de vos numéros de téléphone twilio.

Voir les instructions de configuration dans le wiki.

Ça ira

  • Laissez d'autres plugins (link magic link planificateur) envoyer des messages à l'aide de Twilio.
  • En option : configurez les notifications DT à envoyer par SMS ou WhatsApp.
  • Fournit une API pour envoyer des messages directement.

Utilisation de l'API

Le plugin Disciple Tools - Channels - Twilio peut être découplé, de manière à fonctionner indépendamment du plugin Disciple Tools - Magic Links ; afin d'envoyer des messages directement.

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

Envoyez un sms à un numéro. Renvoie une valeur booléenne indiquant si le message a été envoyé avec succès.

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

Envoyez un message WhatsApp à un numéro. Remarque : Cela ne fonctionnera que si le contact vous a envoyé un message WhatsApp au cours des dernières 24 heures. Renvoie une valeur booléenne indiquant si le message a été envoyé avec succès.

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

Envoyer un message à un utilisateur DT

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

Envoyer un message à un contact DT

$bool_result = dt_twilio_direct_send( 343, 'post', $msg, [ 'service' => 'sms' ] );
  • id: ID utilisateur WP attribué ou identifiant de publication, en fonction de la valeur du type.
  • Type: Type de système; qui doit être l'un des éléments suivants :
    • wp_user
    • poster
  • msg : Message réel à envoyer ; qui doit respecter la forme prédéfinie du modèle de message Twilio. Par exemple:
    Hi, Please update records -> {{link}} -> Link will expire on {{time}}
    • {{...}} espaces réservés à remplacer par des valeurs réelles.
  • arguments : Possibilité de spécifier des remplacements d'options lors de l'envoi. Actuellement, les remplacements suivants sont pris en charge :
    • service: Spécifiez lesquels des types de services twilio suivants doivent être adoptés :
      • sms
      • whatsapp

Contribution

Contributions bienvenues. Vous pouvez signaler des problèmes et des bogues dans le Questions section du dépôt. Vous pouvez présenter des idées dans le Discussions section du dépôt. Et les contributions de code sont les bienvenues en utilisant le Demande de tirage système pour git. Pour plus de détails sur la contribution, voir le directives de contribution.