Hopp til hovedinnhold

Clearstream

Utløs en Clearstream-tekstmelding fra en hvilken som helst B1-hendelse, som ny person, ny gave, skjemainnsending eller oppdatering i kalenderen, og hent svar tilbake som B1-poster. Clearstreams Zapier-app dekker begge retninger, så hele oppsettet er en oppskrift og ikke egendefinert kode.

Før du begynner

  • En Clearstream-konto med minst én liste og en SMS-kvote
  • En Zapier-konto
  • En B1 Admin-bruker med tillatelsen Rediger innstillinger

Hva du kan koble sammen​

RetningUtløserHandling
B1 → ClearstreamB1 person.createdClearstream: Opprett/oppdater abonnent + Send tekst til nummer
B1 → ClearstreamB1 donation.createdClearstream: Send tekst til liste (f.eks. varsle økonomiteamet)
B1 → ClearstreamB1 form.submission.createdClearstream: Send tekst til en rutingliste (f.eks. teamet for bønnebehov)
Clearstream → B1Ny innkommende tekstB1: Opprett person; merk med søkeordet de skrev

Clearstreams Zapier-handlinger: Send tekst til nummer, Send tekst til liste, Opprett/oppdater abonnent, Legg abonnent til i automatisk arbeidsflyt, Legg merkelapp til abonnent, Fjern abonnent fra liste.

Oppsett​

1. Lag en B1 API-nøkkel​

Innstillinger → Utvikler → API-nøkler → Ny API-nøkkel:

  • settings:write: kreves for å koble nøkkelen til Zapier og for at B1 skal registrere utløser-webhooken
  • people:read: trengs for å slå opp personen fra hendelsen (personId → navn/telefon/e-post)
  • (Valgfritt) people:write hvis svar fra Clearstream skal opprette B1-kontakter

2. Bygg Zapen «tekst ved ny gave»​

  1. Utløser: B1.church: Ny gave
  2. Handling: B1.church: Finn person (gavens personId)
  3. Handling: Clearstream: Send tekst til nummer. Bruk personens telefon fra steg 2 som mottaker, og skriv meldingen ("Thanks for your gift, {first}! …").

Slå på Zapen. B1 registrerer gave-webhooken når den aktiveres. Du vil se Zapier — donation.created under Innstillinger → Utvikler → Webhooks.

3. (Valgfritt) Hent svar tilbake som B1-poster​

  1. Utløser: Clearstream: Ny innkommende tekst
  2. Handling: Filter i Zapier på søkeordet, f.eks. fortsett bare hvis tekstinnholdet starter med PRAY
  3. Handling: Lagre tekstinnholdet et sted teamet ditt ser det (Slack, et Google-regneark eller en B1-oppgave). B1s Finn person slår opp personer bare etter ID, e-post eller navn, ikke etter telefon. Koble derfor svaret til en B1-person manuelt (eller legg til et Webhooks by Zapier GET-kall mot B1s endepunkt /membership/people/search/phone?number=…).

Vanlige oppskrifter​

Personsøk til frivillig team​

  • Utløser: B1.church: Ny skjemainnsending (filtrert på ID-en til bønnebehov-skjemaet)
  • Handling: Clearstream: Send tekst til liste, der listen er ditt pastorale vaktteam. Skriv meldingen slik: New prayer request: {data.questions.0.answer}.

Oppfølgingsserie for førstegangsbesøkende​

  • Utløser: B1.church: Ny person, filtrert på personens medlemsstatus (f.eks. Besøkende)
  • Handling: Clearstream: Legg abonnent til i automatisk arbeidsflyt. Koble arbeidsflyt-ID-en til en ferdig 7-dagers tekstserie.

Gruppepåmelding styrt av søkeord​

  • Utløser: Clearstream: Ny innkommende tekst (filtrer på søkeordet MENS)
  • Handling: B1.church: Opprett person fra avsenderens navn og telefon (B1s Finn person kan ikke slå opp personer etter telefon, så sjekk for duplikater senere under Personer)
  • Handling: B1.church: Legg gruppemedlem til i gruppen Menns tjeneste

Begrensninger og merknader​

  • Clearstream måler SMS per melding. Hver handling Send tekst bruker ett eller flere kreditter, avhengig av lengde og antall mottakere. Sjekk kvoten i abonnementet ditt.
  • Telefonnummeret må være i E.164-format (f.eks. +15555550199) for Send tekst til nummer. B1-personposten lagrer det som ble skrevet inn. Bruk et steg Formatter by Zapier: Numbers → Format Phone Number hvis du ikke kan garantere formatet.
  • B1 trenger ingen header fra sin side. Clearstreams autentisering ligger helt inne i Zapier-tilkoblingen.

Feilsøking​

  • Utløseren starter aldri: Settings → Developer → Webhooks skal vise en rad Zapier — <event> etter at Zapen er slått på. Hvis ikke, mangler B1 API-nøkkelen settings:write. Lag en ny nøkkel og koble til på nytt.
  • Clearstream svarer «Invalid phone number»: mottakerfeltet er ikke i E.164. Legg til et steg Format Phone Number.
  • Send tekst til liste mislykkes med 403: Clearstream-API-brukeren mangler tilgang til listen, eller listens ID er feil. List-ID-er vises på detaljsiden for listen i Clearstream.

Se også​