
# MemberPress

> **Kenelle tämä on tarkoitettu?** Yrityksille, jotka myyvät jäsenyyksiä, kursseja tai maksullisia yhteisöjä MemberPressin kautta omalla WordPress-sivustollaan. Jos et käytä MemberPressiä, voit ohittaa tämän sivun.
>
> Käytätkö jotain muuta jäsenyystyökalua? Mikä tahansa työkalu, jossa on API, voidaan silti yhdistää: katso [Sellaisen työkalun yhdistäminen, jota emme listaa](connecting-other-tools.md).

MemberPress on WordPress-lisäosa, joka myy ja suojaa jäsenyyksiä: jäsenet, heidän jäsenyytensä, tilauksensa ja maksunsa. Sen yhdistäminen <span data-t="appName">DM Champ</span>-palveluun antaa [automaatioillesi](../automations/automations.md) vaiheita, jotka lukevat jäsenen tilan ja myöntävät jäsenyyden, jotta tekoälyagenttisi voi vastata kysymykseen "mitä olen tilannut" todellisten tietojen perusteella, ja uusi ostaja voidaan päästää sisään ilman, että kenenkään tarvitsee avata WordPressiä.

WordPress-sivustollesi ei asenneta mitään muuta kuin MemberPressin oma lisäosa, joka on kuvattu alla. Yhdistät oman sivustosi omalla API-avaimellasi.

**Saatavuus:** Automaatiot ovat käytettävissä jokaisella tilillä. Ne löytyvät jo sivupalkistasi, eikä mitään tarvitse ottaa käyttöön tai pyytää erikseen.

---

## Mitä tarvitset

- MemberPress WordPress-sivustolla, joka on tavoitettavissa **https**-yhteydellä ja jossa on **kauniit permalinkit** käytössä (**Asetukset → Osoiterakenne**, mikä tahansa muu kuin "Oletus"), mikä saa `/wp-json/`-osoitteen toimimaan.
- MemberPressin **Developer Tools** -lisäosa, joka kytkee sen API:n päälle. Se sisältyy MemberPressin korkeampiin tilauspaketteihin, joten jos et löydä sitä, tarkista tämä ensimmäisenä.
- Sen antama **API-avain**: WordPressissä, **MemberPress → Developer Tools → API key**.

---

## MemberPressin yhdistäminen

Yhdistät automaation sisältä, kun käytät MemberPress-vaihetta ensimmäistä kertaa.

1. Avaa **Automaatiot** sivupalkista (**AI Studio** -ryhmän alta) ja avaa tai luo automaatio.
2. Lisää vaihe ja etsi **MemberPress** vaiheiden valitsimesta.
3. Valitse haluamasi toiminto. Vaihe pyytää sinua yhdistämään ensin.
4. Täytä kaksi kenttää:
   - **Site URL** on sen WordPress-sivuston osoite, jossa MemberPress toimii, alkaen `https://`.
   - **API key** on **MemberPress → Developer Tools** -kohdasta löytyvä avain.
5. Napsauta yhdistä.

Tarkistamme avaimen sivustoasi vasten ennen kuin tallennamme mitään. Väärä osoite, väärä avain tai se, ettei Developer Tools ole aktiivinen, hylätään näytöllä syyn kera, joten et koskaan saa yhteyttä, joka näyttää toimivalta mutta epäonnistuu automaation ensimmäisellä suorituskerralla. API-avaimesi tallennetaan salattuna, eikä sitä näytetä sinulle uudelleen. Kadotitko sen? Luo uusi MemberPressissä ja yhdistä uudelleen.

---

## Toiminnot

Jokainen toiminto on vaihe automaatiokaaviossa, ja jokainen kenttä hyväksyy tietoja aiemmista vaiheista tavallisilla tietojen lisäyspainikkeilla.

### Hae jäsen (Get member)

Hakee yhden jäsenen: hänen profiilinsa ja jäsenyytensä.

- **Jäsenen ID** määrittää, kenen jäsenen tiedot haetaan. Pakollinen.

### Etsi jäsen sähköpostiosoitteen perusteella

Etsii jäsenen sähköpostiosoitteen perusteella ja palauttaa hänen tunnuksensa (id).

- **Sähköposti** on haettava osoite. Pakollinen, yleensä liipaisimen (trigger) tuottama yhteyshenkilön sähköpostiosoite.

Tämä vaihe muuntaa sähköpostiosoitteen jäsennumeroksi, jota muut vaiheet tarvitsevat.

### Luo jäsen

Luo jäsentilin. Se ei itsessään anna jäsenyyttä; **Luo tapahtuma** (Create transaction) tekee sen.

- **Sähköposti** on jäsenen sähköpostiosoite. Pakollinen.
- **Käyttäjätunnus** on nimi, jolla jäsen kirjautuu sisään. Pakollinen.
- **Etunimi** ja **Sukunimi** ovat valinnaisia.
- **Salasana** on valinnainen. Jos jätetään tyhjäksi, MemberPress luo sellaisen.

### Listaa jäsenen tilaukset

Kaikki yhdelle jäsenelle kuuluvat tilaukset, uusimmasta alkaen.

- **Jäsenen ID** määrittää, kenen jäsenen tiedot haetaan. Pakollinen.

### Listaa jäsenen tapahtumat

Kaikki yhdelle jäsenelle kuuluvat maksut, uusimmasta alkaen.

- **Jäsenen ID** määrittää, kenen jäsenen tiedot haetaan. Pakollinen.

### Luo tapahtuma

Tallentaa maksun, jonka avulla MemberPress myöntää jäsenyyden.

- **Jäsen-ID** on se, joka saa sen. Pakollinen.
- **Jäsenyys-ID** on se, mitä he saavat: jäsenyyden ID kohdasta **MemberPress → Jäsenyydet**. Pakollinen.
- **Summa** on maksettu määrä. Valinnainen.
- **Tila** päättää, lasketaanko se: `complete` on se, mikä myöntää pääsyn, ja sitä se käyttää, kun jätät kentän tyhjäksi.
- **Erääntyy** on ajankohta, jolloin pääsy päättyy, kirjoitettuna päivämääränä ja kellonaikana, esimerkiksi `2027-01-31 23:59:59`. **Jätä se tyhjäksi, jos haluat pääsyn, joka ei vanhene.**

---

## Esimerkkiautomaatio

**Vastaa jäsenen omiin kysymyksiin todellisista tiedoista.**

1. **Käynnistin:** tekoälyagenttisi kutsuu tätä automaatiota työkaluna, kun joku kysyy jäsenyydestään. (Lisää automaatio **tekoälyagentin toiminnoksi**, niin agentti voi suorittaa sen keskustelun aikana.)
2. **Etsi jäsen sähköpostilla** käyttäen yhteyshenkilön sähköpostiosoitetta.
3. **Listaa jäsenen tilaukset** käyttäen vaiheen 2 ID:tä.
4. Tulokset palautetaan agentille, joka vastaa selkokielellä: mikä jäsenyys, onko se aktiivinen ja milloin se uusiutuu.

**Ja toiseen suuntaan: päästä joku sisään maksun jälkeen.**

1. **Käynnistin:** **Webhook**, johon maksujärjestelmä osoittaa.
2. **Etsi jäsen sähköpostilla**. **Ehto**-vaihe haarautuu sen mukaan, onko jäsen olemassa.
3. Jos ei, **Luo jäsen** hänen sähköpostillaan ja käyttäjänimellään.
4. **Luo tapahtuma** jäsenen ID:llä, myönnettävällä jäsenyys-ID:llä, summalla ja **Erääntyy**-ajalla, jos pääsy on määräaikainen.
5. **Lähetä viesti** -vaihe kertoo heille WhatsAppissa, että he ovat päässeet sisään.

---

## Hyvä tietää

- **Vaiheet, jotka vaativat jäsen-ID:n, tulevat Etsi-vaiheen jälkeen.** Etsi jäsen ensin sähköpostilla ja anna sitten ID seuraavalle vaiheelle.
- **Tulosteet kulkevat eteenpäin.** Kaikki, mitä toiminto palauttaa, on myöhempien vaiheiden käytettävissä muuttujina.
- **Jäsenyys myönnetään kirjaamalla maksu.** Näin MemberPress itse toimii: **Luo jäsen** luo tilin, **Luo tapahtuma** `complete`-tilalla avaa oven.
- **Ei ole käynnistintä, joka tarkkailee MemberPressiä.** Mikään ei kysele siltä uusia jäseniä tai maksuja. Jos haluat MemberPressin käynnistävän automaation, lisää automaatioon **Webhook**-käynnistin ja osoita MemberPressin webhook siihen osoitteeseen, jonka se antaa.
- **API vaatii Developer Tools -lisäosan.** Ilman sitä sivustollasi ei ole mitään, minkä kanssa voimme keskustella, vaikka muut tietosi olisivat oikein.
- **Kaikki, mitä ei ole yllä olevassa listassa**, voidaan silti tehdä **HTTP-pyyntö**-vaiheella.

---

## Seuraavat vaiheet

- [Automaatiot](../automations/automations.md): käynnistimet, vaiheet, ehdot ja työnkulun rakentaminen.
- [WordPress](wordpress.md): julkaisut ja käyttäjät samalla sivustolla.
- [FluentCRM](fluentcrm.md): yhteystiedot, tunnisteet ja listat samalla sivustolla.
- [Sellaisen työkalun yhdistäminen, jota emme listaa](connecting-other-tools.md): mukautetut toiminnot, API ja webhookit.
