كيفية تكوين واجهة برمجة تطبيقات Sendpulse

توجد خطة اشتراك مجانية على Sendpulse تتيح لك إرسال رسائل بريد إلكتروني فردية.

لاستخدام واجهة برمجة تطبيقات Sendpulse، ستحتاج إلى المعرف (ID) والسر (Secret)، كما ستحتاج إلى تسجيل عنوان البريد الإلكتروني للمرسل.

يمكنك إرسال رسائل البريد الإلكتروني فقط من عنوان البريد الإلكتروني الذي حددته أثناء عملية التسجيل.

يمكنك تسجيل البريد الإلكتروني للإرسال في قسم SMTP

كيفية إعداد إرسال رسائل البريد الإلكتروني من المحرر

لإرسال بريد إلكتروني، تحتاج إلى لصق هذا في علامة التبويب "الآلة الحاسبة":

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

حيث

api_id — معرف API من Sendpulse
api_secret — سر API من Sendpulse
from_email — عنوان البريد الإلكتروني للمرسل
to_email — عنوان البريد الإلكتروني للمستلم
subject — موضوع البريد الإلكتروني
message — نص البريد الإلكتروني (الرسالة نفسها)
from_name — اسم المرسل

لإرسال قالب:

أولاً، قم بتعيين القيمة للمتغير template، وهي بيانات القالب المطلوب:

template = { "id": "رقم القالب", "variables": { "اسم المتغير": "قيمة المتغير", "اسم المتغير": "قيمة المتغير" }}

ثم قم باستدعاء الدالة

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

حيث

api_id — معرف API من Sendpulse
api_secret — سر API من Sendpulse
from_email — عنوان البريد الإلكتروني للمرسل
to_email — عنوان البريد الإلكتروني للمستلم
subject — موضوع البريد الإلكتروني
template — قيمة المتغير الذي قمنا بتعيينه أعلاه

للتسهيل، دعنا نلقي نظرة على مثال لبوت يطلب إلى من، وبأي موضوع ونص يجب إرسال البريد الإلكتروني.

دعنا نحفظ قيم api_id و api_secret في المتغيرات. للقيام بذلك، انتقل إلى إعدادات مشروع Mavibot.

ثم قم بإنشاء مخطط يجمع البيانات.

الآن دعنا نختبره:

كيفية إضافة بريد إلكتروني إلى دفتر العناوين

لإضافة عنوان بريد إلكتروني إلى دفتر العناوين، استخدم هذه الطريقة:

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

حيث

api_id — معرف API من Sendpulse
api_secret — سر API من Sendpulse
book_id — معرف دفتر العناوين
email — البريد الإلكتروني الذي تحتاج إلى إضافته
variables — (اختياري) مصفوفة من المتغيرات. إذا كنت بحاجة إلى تعيينها، فيجب أن تكون بهذا التنسيق: {"variable_name":"variable_value"}

كيفية إرسال رسالة نصية قصيرة (SMS)

لإرسال رسالة نصية قصيرة، الصق هذه الدالة في علامة التبويب "الآلة الحاسبة":

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

حيث

api_id — معرف API من Sendpulse
api_secret — سر API من Sendpulse
sender — اسم المرسل (أقل من 11 رمزًا لاتينيًا، يمكنك استخدام الأرقام)
phone — رقم هاتف المستلم
text — نص الرسالة، تحتاج إلى وضعه بين قوسين إذا كنت لا تستخدم متغيرًا
transliterate — transliterate = 1 (مع الترجمة الصوتية)، بدون ترجمة صوتية = 0
route — قائمة القنوات للإرسال في البلدان، يمكنك تعيينها على None