Mobile Message
Mobile Message — австралийский SMS API, популярный среди церквей в Австралии: он предлагает местные номера и выгодные австралийские тарифы, тогда как Clearstream и Text In Church ориентированы на США. Приложения Mobile Message для Zapier пока нет, но у сервиса есть публичный REST API, поэтому связать события B1 с SMS Mobile Message можно за несколько минут через Webhooks by Zapier (или модуль HTTP в Make).
Прежде чем начать
- Учётная запись Mobile Message с зарегистрированным Sender ID и учётными данными API (имя пользователя и пароль API в разделе Account → API Settings)
- Учётная запись Zapier (или Make)
- Пользователь B1Admin с правом Edit Settings
Что можно связать
API Mobile Message устроен как «отправка SMS» — триггеров нет, есть только исходящие сообщения. Поэтому все рецепты идут в направлении B1 → SMS:
| Направление | Триггер B1 | Результат |
|---|---|---|
| B1 → Mobile Message | person.created | Приветственное SMS новому человеку |
| B1 → Mobile Message | donation.created | Благодарственное SMS жертвователю |
| B1 → Mobile Message | form.submission.created | Вызов дежурной команды |
| B1 → Mobile Message | event.created | Напоминание, разосланное списку |
Настройка
1. Создайте API-ключ B1
Settings → Developer → API Keys → New API Key:
settings:write— чтобы зарегистрировался веб-хук триггераpeople:read— чтобы поpersonIdнайти номер телефона получателя
2. Создайте Zap с Webhooks by Zapier
- Триггер — B1.church: выберите нужное событие (например, New Donation).
- Действие — B1.church: Find Person (по
data.personId), чтобы получить номер телефона и имя. - Действие — Webhooks by Zapier: POST. Настройте, как показано ниже.
Настройки шага POST:
- URL —
https://api.mobilemessage.com.au/v1/messages - Payload Type — JSON
- Data —
{
"messages": [
{
"to": "{{step2_phone}}",
"message": "Thanks for your gift, {{step2_first_name}}!",
"sender": "YourChurch"
}
]
} - Headers —
Content-Type: application/json(Webhooks by Zapier добавляет это автоматически) - Basic Auth — в поле Basic Auth укажите
<api_username>|<api_password>(Zapier преобразует это в нужный заголовокAuthorization: Basic …)
Включите Zap. Чтобы проверить, что SMS приходит, отправьте тестовое пожертвование в B1Admin.
Типичные рецепты
Напоминания о событиях утром в день события
- Триггер — Schedule by Zapier (ежедневно, в 7:00)
- Действие — ведите список сегодняшних событий в Google Sheets (или другом приложении, которое может читать Zapier) и ищите сегодняшние строки — в приложении B1 для Zapier нет действия поиска событий
- Действие — Webhooks by Zapier: POST в Mobile Message со списком событий для зарегистрированной группы подписчиков
Используйте пакетную конечную точку для рассылки списку
Конечная точка /v1/messages в Mobile Message принимает до 10 000 сообщений за вызов. Чтобы разослать сообщение группе B1:
- Триггер — B1.church: New Form Submission (фильтр по конкретной форме)
- Действие — Webhooks by Zapier: GET
/membership/groupmembers?groupId=…, чтобы получить участников целевой группы (в приложении B1 для Zapier для этого нет действия списка; передайте API-ключ в заголовкеAuthorization: Bearer cak_…) - Действие — Formatter by Zapier → Utilities → Line-itemize: превратите ответ в массив
messages - Действие — Webhooks by Zapier: POST всего массива в
/v1/messages
Вариант с Make
Если вы предпочитаете Make, добавьте модуль HTTP — Make a request после триггера B1 Watch Events и настройте его так же (POST, Basic Auth, тело JSON). Сторону B1 см. в обзоре Make — учтите, что приложение B1.church для Make пока не выпущено.
Ограничения и примечания
- Basic Auth — единственный способ аутентификации. Mobile Message выдаёт имя пользователя и пароль из панели управления. Относитесь к обоим как к секретам.
senderдолжен быть зарегистрированным Sender ID в вашей учётной записи Mobile Message, иначе отправка вернёт400 Invalid sender. Правила Австралии требуют регистрации отправителя.- Австралийские номера телефонов могут быть в формате
0412345678(местном) или+61412345678(международном). API принимает оба, но если вы отправляете и за границу, приводите номера к виду+61…. - До 10 000 сообщений в запросе — удобно для рассылок, но одна доставка веб-хука B1 редко содержит такой большой список; пакетную конечную точку оставляйте для плановых массовых Zap.
Устранение неполадок
- POST возвращает
401 Unauthorized— учётные данные Basic Auth неверны. Скопируйте их заново из панели Mobile Message в разделе Account → API Settings. Учтите, что имя пользователя по умолчанию — адрес электронной почты вашей учётной записи, а не отдельный API-ключ. - POST возвращает
400 Invalid sender— значениеsenderне является зарегистрированным Sender ID в вашей учётной записи. Сначала зарегистрируйте его в панели Mobile Message. - SMS приходит обрезанным — Mobile Message разбивает сообщения длиннее примерно 160 символов на несколько частей, и плата взимается за каждую часть. Проверьте тело ответа — там указано количество частей.
См. также
- Clearstream, Text In Church — альтернативные провайдеры SMS с нативными приложениями Zapier (шаг Webhooks by Zapier не нужен)
- Zapier (обзор) — сторона B1 в каждом рецепте Zapier
- Документация API Mobile Message