# Sendpulse

* [Як налаштувати API Sendpulse](#how-to-configure-sendpulse-api)&#x20;
* [Як налаштувати надсилання електронних листів із редактора](#how-to-set-up-sending-emails-from-the-editor)&#x20;
* [Як додати електронну пошту до адресної книги](#how-to-add-an-email-to-the-address-book)&#x20;
* [Як надіслати SMS](#how-to-send-an-sms)

## Як налаштувати API Sendpulse

У Sendpulse є безкоштовний тарифний план, який дає змогу надсилати одноразові електронні листи.

Щоб використовувати API Sendpulse, вам знадобляться ID, Secret, а також потрібно буде зареєструвати електронну адресу відправника.

{% hint style="info" %}
Ви можете надсилати електронні листи лише з тієї електронної адреси, яку вказали під час реєстрації.
{% endhint %}

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

Ви можете зареєструвати електронну адресу для надсилання в розділі SMPT

## Як налаштувати надсилання електронних листів із редактора

Щоб надіслати **email**, вам потрібно вставити це на вкладку Calculator:

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

де

**api\_id** — API id у Sendpulse \
**api\_secret** — Secret у Sendpulse \
**from\_email** — електронна адреса відправника \
**to\_email** — електронна адреса отримувача \
**subject** — тема листа \
**message** — текст листа (саме повідомлення) \
**from\_name** — ім'я відправника

Щоб надіслати **шаблон**:&#x20;

Спочатку встановіть значення змінної template — це дані про потрібний шаблон:

**template = { "id": "Номер шаблону", "variables": { "назва змінної": "значення змінної", "назва змінної": "значення змінної" }}**

Потім викличте функцію

**sendpulse\_email\_template(api\_id, api\_secret, from\_email, to\_email, subject, template)**

де

**api\_id** — API id у Sendpulse \
**api\_secret** — 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 id у Sendpulse \
**api\_secret** — Secret у Sendpulse \
**book\_id** — id адресної книги \
**email** — електронна адреса, яку потрібно додати \
**variables** — (необов'язково) масив змінних. Якщо вам потрібно його задати, він має бути в такому форматі: {“variable\_name”:”variable\_value”}

## Як надіслати SMS

Щоб надіслати SMS, вставте цю функцію на вкладку Calculator:

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

де

**api\_id** — API id у Sendpulse \
**api\_secret** — Secret у Sendpulse \
**sender** — ім'я відправника (до 11 латинських символів, можна використовувати цифри) \
**phone** — номер телефону отримувача \
**text** — текст повідомлення, його потрібно взяти в дужки, якщо ви не використовуєте змінну \
**transliterate** — 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/uk/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.
