Loops

Loops — это почтовая платформа, созданная для современных SaaS-компаний, предлагающая транзакционные письма, маркетинговые кампании и автоматизацию на основе событий через чистый API. Эта интеграция подключает Loops непосредственно к рабочим процессам AACFlow.

С Loops в AACFlow вы можете:

Управлять контактами: Создавать, обновлять, находить и удалять контакты в вашей аудитории Loops
Отправлять транзакционные письма: Запускать шаблонные транзакционные письма с динамическими переменными данных
Отправлять события: Отправлять события в Loops для запуска автоматических последовательностей писем и рабочих процессов
Управлять подписками: Программно управлять подписками на рассылки и свойствами контактов
Обогащать данные контактов: Прикреплять пользовательские свойства, группы пользователей и членства в рассылках к контактам

В AACFlow интеграция с Loops позволяет вашим агентам управлять почтовыми операциями в рамках своих рабочих процессов. Поддерживаемые операции включают:

Создать контакт: Добавить новый контакт в вашу аудиторию Loops с email, именем и пользовательскими свойствами.
Обновить контакт: Обновить существующий контакт или создать его, если совпадение не найдено (поведение upsert).
Найти контакт: Найти контакт по адресу электронной почты или userId.
Удалить контакт: Удалить контакт из вашей аудитории.
Отправить транзакционное письмо: Отправить шаблонное транзакционное письмо получателю с динамическими переменными данных.
Отправить событие: Запустить событие Loops для начала автоматических последовательностей писем для контакта.

Настройте блок Loops с вашим API-ключом из панели управления Loops (Настройки > API), выберите операцию и укажите необходимые параметры. Ваши агенты смогут управлять контактами и отправлять письма в рамках любого рабочего процесса.

Инструкции по использованию

Интегрируйте Loops в рабочий процесс. Создавайте и управляйте контактами, отправляйте транзакционные письма и запускайте автоматизацию на основе событий.

Инструменты

`loops_create_contact`

Создать новый контакт в вашей аудитории Loops с адресом электронной почты и дополнительными свойствами, такими как имя, группа пользователей и подписки на рассылки.

Входные параметры

Параметр	Тип	Обязательный	Описание
`apiKey`	string	Да	API-ключ Loops для аутентификации
`email`	string	Да	Адрес электронной почты для нового контакта
`firstName`	string	Нет	Имя контакта
`lastName`	string	Нет	Фамилия контакта
`source`	string	Нет	Пользовательское значение источника, заменяющее значение по умолчанию "API"
`subscribed`	boolean	Нет	Получает ли контакт кампанийные письма (по умолчанию: true)
`userGroup`	string	Нет	Группа для сегментации контакта (одна группа на контакт)
`userId`	string	Нет	Уникальный идентификатор пользователя из вашего приложения
`mailingLists`	json	Нет	ID рассылок, сопоставленные с логическими значениями (true для подписки, false для отписки)
`customProperties`	json	Нет	Пользовательские свойства контакта в виде пар ключ-значение (строковые, числовые, логические значения или даты)

Выходные данные

Параметр	Тип	Описание
`success`	boolean	Успешно ли создан контакт
`id`	string	ID созданного контакта, назначенный Loops

`loops_update_contact`

Обновить существующий контакт в Loops по email или userId. Создает новый контакт, если совпадение не найдено (upsert). Может обновлять имя, статус подписки, группу пользователей, рассылки и пользовательские свойства.

Входные параметры

Параметр	Тип	Обязательный	Описание
`apiKey`	string	Да	API-ключ Loops для аутентификации
`email`	string	Нет	Адрес электронной почты контакта (требуется хотя бы один из email или userId)
`userId`	string	Нет	userId контакта (требуется хотя бы один из email или userId)
`firstName`	string	Нет	Имя контакта
`lastName`	string	Нет	Фамилия контакта
`source`	string	Нет	Пользовательское значение источника, заменяющее значение по умолчанию "API"
`subscribed`	boolean	Нет	Получает ли контакт кампанийные письма (отправка true повторно подписывает отписавшихся контактов)
`userGroup`	string	Нет	Группа для сегментации контакта (одна группа на контакт)
`mailingLists`	json	Нет	ID рассылок, сопоставленные с логическими значениями (true для подписки, false для отписки)
`customProperties`	json	Нет	Пользовательские свойства контакта в виде пар ключ-значение (отправьте null для сброса свойства)

Выходные данные

Параметр	Тип	Описание
`success`	boolean	Успешно ли обновлен контакт
`id`	string	ID обновленного или созданного контакта, назначенный Loops

`loops_find_contact`

Найти контакт в Loops по адресу электронной почты или userId. Возвращает массив соответствующих контактов со всеми их свойствами, включая имя, статус подписки, группу пользователей и рассылки.

Входные параметры

Параметр	Тип	Обязательный	Описание
`apiKey`	string	Да	API-ключ Loops для аутентификации
`email`	string	Нет	Адрес электронной почты контакта для поиска (требуется хотя бы один из email или userId)
`userId`	string	Нет	userId контакта для поиска (требуется хотя бы один из email или userId)

Выходные данные

Параметр	Тип	Описание
`contacts`	array	Массив объектов соответствующих контактов (пустой массив, если совпадение не найдено)
↳ `id`	string	ID контакта, назначенный Loops
↳ `email`	string	Адрес электронной почты контакта
↳ `firstName`	string	Имя контакта
↳ `lastName`	string	Фамилия контакта
↳ `source`	string	Источник, из которого был создан контакт
↳ `subscribed`	boolean	Получает ли контакт кампанийные письма
↳ `userGroup`	string	Группа пользователей контакта
↳ `userId`	string	Внешний идентификатор пользователя
↳ `mailingLists`	object	ID рассылок, сопоставленные со статусом подписки
↳ `optInStatus`	string	Статус двойного подтверждения: pending, accepted, rejected или null

`loops_delete_contact`

Удалить контакт из Loops по адресу электронной почты или userId. Должен быть указан хотя бы один идентификатор.

Входные параметры

Параметр	Тип	Обязательный	Описание
`apiKey`	string	Да	API-ключ Loops для аутентификации
`email`	string	Нет	Адрес электронной почты контакта для удаления (требуется хотя бы один из email или userId)
`userId`	string	Нет	userId контакта для удаления (требуется хотя бы один из email или userId)

Выходные данные

Параметр	Тип	Описание
`success`	boolean	Успешно ли удален контакт
`message`	string	Сообщение о статусе от API

`loops_send_transactional_email`

Отправить транзакционное письмо получателю с использованием шаблона Loops. Поддерживает динамические переменные данных для персонализации и при необходимости добавляет получателя в вашу аудиторию.

Входные параметры

Параметр	Тип	Обязательный	Описание
`apiKey`	string	Да	API-ключ Loops для аутентификации
`email`	string	Да	Адрес электронной почты получателя
`transactionalId`	string	Да	ID шаблона транзакционного письма для отправки
`dataVariables`	json	Нет	Переменные данных шаблона в виде пар ключ-значение (строковые или числовые значения)
`addToAudience`	boolean	Нет	Создавать ли получателя как контакт, если он еще не существует (по умолчанию: false)
`attachments`	json	Нет	Массив вложений файлов. Каждый объект должен иметь filename (строка), contentType (строка типа MIME) и data (строка в кодировке base64).

Выходные данные

Параметр	Тип	Описание
`success`	boolean	Успешно ли отправлено транзакционное письмо

`loops_send_event`

Отправить событие в Loops для запуска автоматических последовательностей писем для контакта. Идентифицируйте контакт по email или userId и включите дополнительные свойства события и изменения рассылок.

Входные параметры

Параметр	Тип	Обязательный	Описание
`apiKey`	string	Да	API-ключ Loops для аутентификации
`email`	string	Нет	Адрес электронной почты контакта (требуется хотя бы один из email или userId)
`userId`	string	Нет	userId контакта (требуется хотя бы один из email или userId)
`eventName`	string	Да	Название события для запуска
`eventProperties`	json	Нет	Данные события в виде пар ключ-значение (строковые, числовые, логические значения или даты)
`mailingLists`	json	Нет	ID рассылок, сопоставленные с логическими значениями (true для подписки, false для отписки)

Выходные данные

Параметр	Тип	Описание
`success`	boolean	Успешно ли отправлено событие

`loops_list_mailing_lists`

Получить все рассылки из вашей учетной записи Loops. Возвращает каждую рассылку с ее ID, названием, описанием и статусом публичной/частной.

Входные параметры

Параметр	Тип	Обязательный	Описание
`apiKey`	string	Да	API-ключ Loops для аутентификации

Выходные данные

Параметр	Тип	Описание

Loops

On this page