Mobile Message
Mobile Message एक ऑस्ट्रेलियाई SMS API है — AU चर्चों में लोकप्रिय, क्योंकि यह स्थानीय नंबर और प्रतिस्पर्धी AU मूल्य निर्धारण देता है, जहाँ Clearstream और Text In Church अमेरिका-केंद्रित हैं। Mobile Message के पास आज पहली-श्रेणी का Zapier ऐप नहीं है, पर वह एक सार्वजनिक REST API प्रकाशित करता है, इसलिए आप Webhooks by Zapier (या Make के HTTP module) के माध्यम से B1 events को Mobile Message texts से कुछ ही मिनटों में वायर कर सकते हैं।
शुरू करने से पहले
- पंजीकृत Sender ID और API credentials वाला Mobile Message account (API username + password, Account → API Settings के अंतर्गत)
- एक Zapier account (या Make)
- Edit Settings अनुमति वाला एक B1Admin user
आप क्या वायर कर सकते हैं
Mobile Message का API "SMS भेजो"-आकार का है — कोई triggers नहीं, केवल outbound text। इसलिए सारी रेसिपी B1 → SMS हैं:
| दिशा | B1 trigger | परिणाम |
|---|---|---|
| B1 → Mobile Message | person.created | नए व्यक्ति को स्वागत text |
| B1 → Mobile Message | donation.created | donor को धन्यवाद text |
| B1 → Mobile Message | form.submission.created | on-call टीम को पेज करना |
| B1 → Mobile Message | event.created | एक list को reminder broadcast |
सेटअप
1. B1 API key बनाएँ
Settings → Developer → API Keys → New API Key:
settings:write— trigger webhook के रजिस्टर होने के लिएpeople:read—personIdसे प्राप्तकर्ता का फ़ोन नंबर खोजने के लिए
2. Webhooks by Zapier के साथ Zap बनाएँ
- Trigger — B1.church: वह event चुनें जो चाहिए (जैसे New Donation)।
- Action — B1.church: Find Person (
data.personIdसे) ताकि फ़ोन नंबर और नाम मिले। - Action — Webhooks by Zapier: POST। नीचे के अनुसार कॉन्फ़िगर करें।
POST चरण की settings:
- 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 …header में बदल देता है)
Zap चालू करें। text पहुँचने की पुष्टि के लिए B1Admin में एक परीक्षण उपहार भेजें।
सामान्य रेसिपी
सुबह के समय event reminders
- Trigger — Schedule by Zapier (रोज़ाना, सुबह 7 बजे)
- Action — आज के events की सूची एक Google Sheet में (या किसी अन्य ऐप में जिसे Zapier पढ़ सके) रखें और आज की पंक्तियाँ खोजें — B1 के Zapier ऐप में events खोजने के लिए कोई action नहीं है
- Action — Webhooks by Zapier: पंजीकृत subscriber group को event सूची के साथ Mobile Message पर POST करें
सूची broadcast के लिए batch endpoint का उपयोग करें
Mobile Message का /v1/messages endpoint प्रति call 10,000 messages तक स्वीकार करता है। किसी B1 group पर broadcast करने के लिए:
- Trigger — B1.church: New Form Submission (किसी विशिष्ट form पर filter)
- Action — Webhooks by Zapier: लक्षित group के सदस्यों की सूची के लिए GET
/membership/groupmembers?groupId=…(B1 के Zapier ऐप में इसके लिए list action नहीं है; API key कोAuthorization: Bearer cak_…header के रूप में भेजें) - Action — Formatter by Zapier → Utilities → Line-itemize प्रतिक्रिया को
messagesarray में बदलने के लिए - Action — Webhooks by Zapier: पूरे array को
/v1/messagesपर POST करें
Make विकल्प
अगर आप Make पसंद करते हैं, तो B1 Watch Events trigger के बाद HTTP — Make a request module रखें, उसे उसी तरह कॉन्फ़िगर करें (POST, Basic Auth, JSON body)। B1 की ओर के लिए Make overview देखें — ध्यान दें कि B1.church Make ऐप अभी रिलीज़ नहीं हुआ है।
सीमाएँ और नोट्स
- Basic Auth ही एकमात्र authentication विधि है — Mobile Message डैशबोर्ड से username और password जारी करता है। दोनों को गुप्त मानें।
senderआपके Mobile Message account पर पंजीकृत Sender ID होना चाहिए, नहीं तो भेजना400 Invalid senderलौटाएगा। AU नियम sender पंजीकरण अनिवार्य करते हैं।- AU फ़ोन नंबर
0412345678(स्थानीय) या+61412345678(अंतरराष्ट्रीय) हो सकते हैं। API दोनों स्वीकार करता है, पर अगर आप विदेश में भी भेजते हैं तो+61…पर सामान्यीकृत करें। - प्रति request 10,000 messages तक — broadcasts के लिए उपयोगी, पर एक B1 webhook delivery शायद ही इतनी बड़ी सूची देगी; batch endpoint को निर्धारित थोक Zaps के लिए रखें।
समस्या निवारण
- POST
401 Unauthorizedलौटाता है — Basic Auth credentials गलत हैं। Mobile Message डैशबोर्ड Account → API Settings से फिर से कॉपी करें। ध्यान दें कि username डिफ़ॉल्ट रूप से आपका account email है, कोई अलग API key नहीं। - POST
400 Invalid senderलौटाता है —senderमान आपके account पर पंजीकृत Sender ID नहीं है। पहले उसे Mobile Message डैशबोर्ड में पंजीकृत करें। - Text पहुँचता है पर कटा हुआ होता है — Mobile Message लगभग 160 अक्षरों से बड़े messages को कई भागों में बाँटता है; हर भाग का शुल्क लगता है। response body जाँचें — उसमें भागों की संख्या दी होती है।
यह भी देखें
- Clearstream, Text In Church — मूल Zapier ऐप वाले वैकल्पिक SMS providers (Webhooks-by-Zapier चरण की ज़रूरत नहीं)
- Zapier (overview) — हर Zapier रेसिपी का B1 हिस्सा
- Mobile Message API docs