Clearstream
Sprožite SMS sporočilo Clearstream iz katerega koli dogodka v B1 (nova oseba, novo darilo, oddana prijava, posodobitev koledarja) in prejemajte odgovore nazaj kot zapise v B1. Clearstreamova aplikacija za Zapier podpira obe smeri, zato je celotna povezava pripravljena kot recept in ne zahteva lastne kode.
Preden začnete
- Clearstream račun z vsaj enim seznamom in SMS kvoto
- Zapier račun
- Uporabnik B1Admin z dovoljenjem Edit Settings
Kaj lahko povežete
| Smer | Sprožilec | Dejanje |
|---|---|---|
| B1 → Clearstream | B1 person.created | Clearstream: Create/Update Subscriber + Send Text to Number |
| B1 → Clearstream | B1 donation.created | Clearstream: Send Text to List (npr. obvestilo finančni ekipi) |
| B1 → Clearstream | B1 form.submission.created | Clearstream: Send Text to a routing list (npr. ekipa za prošnje za molitev) |
| Clearstream → B1 | New Incoming Text | B1: Create Person; označi z ključno besedo, ki so jo poslali s SMS-om |
Clearstreamova dejanja v Zapierju: Send Text to Number, Send Text to List, Create/Update Subscriber, Add Subscriber to Automated Workflow, Add Tag to Subscriber, Remove Subscriber From List.
Nastavitev
1. Ustvarite API ključ za B1
Settings → Developer → API Keys → New API Key:
settings:write— potreben, da B1 registrira webhook za sprožilecpeople:read— potreben za iskanje osebe iz dogodka (personId→ ime/telefon/e-pošta)- (Neobvezno)
people:write, če naj odgovori Clearstream ustvarjajo kontakte v B1
2. Ustvarite Zap „SMS ob novem darilu“
- Sprožilec — B1.church: New Donation
- Dejanje — B1.church: Find Person (
personIddarila) - Dejanje — Clearstream: Send Text to Number. Kot prejemnika uporabite telefonsko številko osebe iz koraka 2 in sestavite sporočilo (
"Thanks for your gift, {first}! …").
Vklopite Zap. B1 ob aktivaciji registrira webhook za darila; v Settings → Developer → Webhooks se bo prikazal Zapier — donation.created.
3. (Neobvezno) Odgovore vrnite nazaj kot zapise v B1
- Sprožilec — Clearstream: New Incoming Text
- Dejanje — Filter by Zapier glede na ključno besedo, npr. nadaljuj le, če se besedilo sporočila začne z
PRAY - Dejanje — B1.church: Find Person (po telefonu)
- Dejanje — Filter / Path: če oseba ni najdena, jo ustvarite; v vsakem primeru shranite besedilo sporočila nekam (Slack, Google Sheet ali oddano prijavo v B1 prek Webhooks by Zapier).
Pogosti recepti
Obveščanje dežurne ekipe
- Sprožilec — B1.church: New Form Submission (filtrirano po ID-ju obrazca za prošnjo za molitev)
- Dejanje — Clearstream: Send Text to List, kjer je seznam vaša dežurna pastoralna ekipa. Telo sporočila sestavite kot
New prayer request: {data.questions.0.answer}.
Zaporedje sledenja za obiskovalce prvič
- Sprožilec — B1.church: New Person, filtrirano po oznaki osebe v B1 „First-time visitor“
- Dejanje — Clearstream: Add Subscriber to Automated Workflow. ID delovnega toka preslikajte v vnaprej pripravljeno 7-dnevno zaporedje SMS-ov.
Pridružitev skupini prek ključne besede
- Sprožilec — Clearstream: New Incoming Text (filter na ključno besedo
MENS) - Dejanje — B1.church: Find Person (po telefonu); pri ne-najdbi → Create Person
- Dejanje — B1.church: Add Group Member skupini Men's Ministry
Omejitve in opombe
- Clearstream šteje SMS-e po sporočilih. Vsako dejanje Send Text porabi enega ali več kreditov, odvisno od dolžine in števila prejemnikov. Preverite kvoto svojega paketa.
- Telefonska številka mora biti v formatu E.164 (npr.
+15555550199) za Send Text to Number. B1 shrani zapis osebe tako, kot je bil vnesen. Če formata ne morete zagotoviti, uporabite korak Formatter by Zapier — Numbers → Format Phone Number. - B1 ne zahteva nobene glave (header). Avtentikacija Clearstreama v celoti poteka prek njegove Zapier povezave.
Odpravljanje težav
- Sprožilec se nikoli ne sproži — po vklopu Zapa mora v
Settings → Developer → Webhooksbiti vrsticaZapier — <event>. Če je ni, B1 API ključu manjkasettings:write. Ustvarite novega ključa in ponovno povežite. - Clearstream vrne „Invalid phone number“ — polje prejemnika ni v formatu E.164. Dodajte korak Format Phone Number.
- Send Text to List javi
403— API uporabnik Clearstreama nima dovoljenja za ta seznam ali pa je ID seznama napačen. ID-je seznamov najdete na strani s podrobnostmi seznama v Clearstreamu.
Glej tudi
- Text In Church — alternativna SMS platforma s podobno zasnovo povezave
- Mobile Message — za cerkve zunaj ZDA
- Zapier (pregled) — stran B1 za vse recepte z Zapierjem
- Clearstream API docs — za lastne integracije onkraj aplikacije Zapier