# Sendpulse

* [كيفية إعداد واجهة برمجة التطبيقات Sendpulse](#how-to-configure-sendpulse-api) 
* [كيفية إعداد إرسال رسائل البريد الإلكتروني من المحرر](#how-to-set-up-sending-emails-from-the-editor) 
* [كيفية إضافة بريد إلكتروني إلى دفتر العناوين](#how-to-add-an-email-to-the-address-book) 
* [كيفية إرسال رسالة SMS](#how-to-send-an-sms)

## كيفية إعداد واجهة برمجة التطبيقات Sendpulse

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

لاستخدام واجهة برمجة التطبيقات Sendpulse، ستحتاج إلى المعرّف والسر، وستحتاج أيضًا إلى تسجيل بريد المرسل الإلكتروني.

{% hint style="info" %}
يمكنك إرسال رسائل البريد الإلكتروني فقط من عنوان البريد الإلكتروني الذي حددته أثناء عملية التسجيل.
{% endhint %}

![](https://lh5.googleusercontent.com/tC8C8c6R_wjZDvMvgk5jiB9VvpcqBe9nSTO8FR-HMKP5ueeVSuP0h7DoYWE8VQ5ktaJV35EqcplElJoFDE33E0POGBbpWgj4w35LH1TN8FhNoVD2RqH0qYqqLcY453PLN_ftgUgyilavLWq1og)

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

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

لإرسال  **البريد الإلكتروني**، عليك لصق هذا في تبويب Calculator:

**sendpulse\_email(api\_id, api\_secret, from\_email, to\_email, subject, message, from\_name)**

حيث

**api\_id** — معرّف API من Sendpulse \
**api\_secret** — السر من 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** — السر من Sendpulse \
**from\_email** — عنوان البريد الإلكتروني للمرسل \
**to\_email** — عنوان البريد الإلكتروني للمستلم \
**subject** — موضوع البريد الإلكتروني \
**قالب** — قيمة المتغير التي قمنا بتعيينها أعلاه

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

لنحفظ  **api\_id** و **api\_secret** القيم في المتغيرات. للقيام بذلك، انتقل إلى إعدادات مشروع Salebot.

![](https://lh3.googleusercontent.com/FsdCNqRclYoa6a6sWQxAIw6ephOuwVkkepVZSvCnhYWEH9VfdvXAqeExCl60p9j2uknvIoCZ7nMYzpFvirv-GFOZqzE1WoBAuregI4EQaIhVGrLgd1CQm6H1yTbTronNH5wlAmy3krgEwG_H6A)

ثم أنشئ مخططًا يجمع البيانات.

![](https://lh6.googleusercontent.com/rCermgFjtqDBoZ8TIBgZlGREgGLxerefrQcY7vYRdERQOExZCZhhBLQ2S_zxObFHq4TSM5kt1BHQO0e_-0fPX1ynAWRvbNSLo3drdRKRJMbIYpmiQQxPAegOfnki8djuwxkfrdbIEnj9KIrEIA)

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

![](https://lh5.googleusercontent.com/ucX81qCR2LnC1KtwUb9iAm76ILV5SNCwKcC-uVp6E9bkl7i_BdaxBDa93aCvJdsxBdD3GFjd2SKkiP-1S5YUom8TMGVRA8496vzVvtWJTLVFFYDMmY4KSPey0DbYe6N-zQrSe-_YXgnPXp0NUA)

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

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

**sendpulse\_add\_to\_addressbook(api\_id, api\_secret, book\_id, email, variables=None)**

حيث

**api\_id** — معرّف API من Sendpulse \
**api\_secret** — السر من Sendpulse \
**book\_id** — معرّف دفتر العناوين \
**البريد الإلكتروني** — البريد الإلكتروني الذي تحتاج إلى إضافته \
**variables** — (اختياري) مصفوفة من المتغيرات. إذا كنت تحتاج إلى تعيينها، فيجب أن تكون بهذا التنسيق: {“variable\_name”:”variable\_value”}

## كيفية إرسال رسالة SMS

لإرسال رسالة SMS، الصق هذه الدالة في تبويب Calculator:

**sendpulse\_sms(api\_id, api\_secret, sender, phone, text, transliterate=0, route=None)**

حيث

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.mavibot.ai/doc/ar/integrations/other/sendpulse.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.