Comment configurer l'API Sendpulse

Il existe un plan d'abonnement gratuit sur Sendpulse qui vous permet d'envoyer des e-mails ponctuels.

Pour utiliser l'API Sendpulse, vous aurez besoin d'un ID, d'un Secret et vous devrez également enregistrer l'adresse e-mail de l'expéditeur.

Vous ne pouvez envoyer des e-mails qu'à partir de l'adresse e-mail que vous avez spécifiée lors de l'inscription.

Vous pouvez enregistrer l'e-mail pour l'envoi dans la section SMTP.

Comment configurer l'envoi d'e-mails depuis l'éditeur

Pour envoyer un e-mail, vous devez coller ceci dans l'onglet Calculatrice :

sendpulse_email(api_id, api_secret, from_email, to_email, subject, message, from_name)

où

api_id — ID API de Sendpulse
api_secret — Secret de Sendpulse
from_email — adresse e-mail de l'expéditeur
to_email — adresse e-mail du destinataire
subject — l'objet de l'e-mail
message — le corps de l'e-mail (le message lui-même)
from_name — nom de l'expéditeur

Pour envoyer un modèle :

D'abord, définissez la valeur de la variable template, ce sont les données du modèle nécessaire :

template = { "id": "Numéro du modèle", "variables": { "nom de la variable": "valeur de la variable", "nom de la variable": "valeur de la variable" }}

Ensuite, appelez la fonction

sendpulse_email_template(api_id, api_secret, from_email, to_email, subject, template)

où

api_id — ID API de Sendpulse
api_secret — Secret de Sendpulse
from_email — adresse e-mail de l'expéditeur
to_email — adresse e-mail du destinataire
subject — l'objet de l'e-mail
template — la valeur de la variable que nous avons définie ci-dessus

Pour plus de simplicité, examinons l'exemple d'un bot qui demande à qui, avec quel objet et quel corps l'e-mail doit être envoyé.

Enregistrons les valeurs api_id et api_secret dans les variables. Pour ce faire, allez dans les paramètres du projet Mavibot.

Créez ensuite un schéma qui collecte les données.

Testons-le maintenant :

Comment ajouter un e-mail au carnet d'adresses

Pour ajouter une adresse e-mail au carnet d'adresses, utilisez cette méthode :

sendpulse_add_to_addressbook(api_id, api_secret, book_id, email, variables=None)

où

api_id — ID API de Sendpulse
api_secret — Secret de Sendpulse
book_id — id du carnet d'adresses
email — l'e-mail que vous devez ajouter
variables — (optionnel) un tableau de variables. Si vous devez le définir, il doit être au format suivant : {“variable_name”:”variable_value”}

Comment envoyer un SMS

Pour envoyer un SMS, collez cette fonction dans l'onglet Calculatrice :

sendpulse_sms(api_id, api_secret, sender, phone, text, transliterate=0, route=None)

où

api_id — ID API de Sendpulse
api_secret — Secret de Sendpulse
sender — nom de l'expéditeur (moins de 11 symboles latins, vous pouvez utiliser des chiffres)
phone — le numéro de téléphone du destinataire
text — le texte du message, vous devez le placer entre guillemets si vous n'utilisez pas de variable
transliterate — translittération = 1, sans translittération = 0
route — la liste des canaux d'envoi dans les pays, vous pouvez la définir sur None