CovBot - WhatsApp -alapú Chatbot a COVID 19 -hez Info és egyebek: 7 lépés

2025 Szerző: John Day | [email protected]. Utoljára módosítva: 2025-01-23 14:47

A CoVbot egy egyszerű és intuitív Whatsapp -alapú chatbot. A bot fő jellemzője:

Egyszerű és intuitív módon megadhatja a COVID-19 legújabb állapotát a választott országban.

Ezenkívül a bot javasolhat szórakoztató tevékenységeket az OTTHON, például:

1. Filmet javasol - Megtekintendő film a Top 10 filmek listájáról, rövid áttekintéssel a cselekményről és az időtartamról. Mivel ez a lista nincs szoftveresen kódolva, mindig az aktuális trendek alapján kapja meg a legújabb frissítéseket.
2. Javasoljon TV -műsort - A legnépszerűbb TV -műsorokból nézhető tévéműsor, rövid áttekintéssel a cselekményről és az értékelésről. Mivel ez a lista nincs szoftveresen kódolva, mindig az aktuális trendek alapján kapja meg a legújabb frissítéseket.
3. Javasoljon könyvet - Egy könyv, amelyet el kell olvasni a Top 10 könyvlistából, a könyv homlokzatával és borítójával.
4. Napi edzések-Ez a videó egy 7 napos edzésterv alapján készült, amelyet a CRANK gym biztosít Instagram-fiókjában.

Ha élvezi ezt az utasítást, kérjük, szavazzon rá az első cikk szerzői versenyében. (és igen, ez az első tanulságos, így ha valami nem világos, vagy további magyarázatra van szüksége, kérjük, jelezze a megjegyzés rovatban, és tudok segíteni:)

Kellékek

Ez a projekt kizárólag szoftver alapú projekt, így bárki, aki ezt az utasítást követi laptop/asztali PC/macOS/Linux és internet segítségével, befejezheti ezt a projektet. A végén egy részletes szakaszt is tartalmazok, hogy részletesebben elmagyarázzam a kódot/folyamatot azoknak, akik némi programozási tapasztalattal rendelkeznek. Kérjük, vegye figyelembe, hogy ez nem szükséges a projekt befejezéséhez

Projekt nehézségi szintje:

Nem túl könnyű, de nem túl nehéz

Az általunk használt hardver:

• Windows/macOS/Linux rendszert futtató laptop/asztali számítógép.
• Mobiltelefon, amelyre telepítve van a WhatsApp Messenger

Az általunk használt szoftver:

1. Python programozási nyelv
2. ngrok - olyan eszköz, amely lehetővé teszi számunkra, hogy a hálózatunkon kívülről is elérjük szerverünket
3. Az Ön által választott szerkesztő: (pl. Notepad ++, Sublime Text, Vim stb.)

1. lépés: Telepítse a szükséges szoftvert

Ebben a lépésben a következőket fogjuk tenni:

1. Telepítse a Python> 3.6 programot, és próbálja ki
2. Telepítse a szükséges python könyvtárakat
3. Telepítse az ngrok programot

Ha mindkét alkalmazás telepítve van, kihagyhatja ezt a lépést

A Python telepítése:

A projekt teljes háttér -szerver kódbázisa a Python 3.6 -ban van írva. Ezért alkalmazásaink futtatásához szükségünk van a Python> 3.6 telepítésére a számítógépünkre. Kövesse a CoreySchafer bemutatóját a python Windows és macOS rendszerre történő telepítéséről

Ellenőrizheti, hogy minden megfelelően van -e telepítve, ha beírja a következő parancsot a cmd/terminálba:

python -c 'print (f "Hello World")'

Ha mindent helyesen telepített, akkor a Hello World -t ki kell nyomtatni a képernyőre. Ha érvénytelen szintaktikai hibát kap, akkor a python rossz verziója van telepítve. Telepítse a python> = 3.6 verzióját

Telepítse a szükséges python könyvtárakat a pip használatával:

A szoftver működéséhez a következő python könyvtárakat fogjuk használni:

1. Lombik - Ez a szerverünk keretrendszere
2. Twilio - Ez a könyvtár lehetőséget biztosít a python számára a WhatsApp -al való kommunikációra
3. Kérés - Ez a könyvtár arra szolgál, hogy adatokat kérjen az API -któl
4. BeautifulSoup4 - Ez a könyvtár a webhelyekről származó információk lekérésére szolgál
5. lxml - Ezt a könyvtárat a BeautifulSoup -szal együtt használják a releváns információk kinyerésére egy webhelyről

A könyvtárak telepítéséhez tegye a következőket:

Nyissa meg a CMD/terminált, és írja be a következő parancsot:

pip install flask, twilio, request, beautifulsoup4, lxml

VAGY

Töltse le a követelmények.txt fájlt, és nyisson meg egy terminált a könyvtárban, ahol a fájl található, és írja be:

pip install -r követelmények.txt

Telepítse az ngrok programot

Az ngrok lehetővé teszi, hogy a helyi gépen futó szervert az internetnek tegye ki. Csak mondja meg az ngrok -nak, hogy melyik porton hallgatja a szervere.

Kövesse az ngrok webhely útmutatóját az ngrok telepítéséhez az Ön által használt operációs rendszerhez.

Tipp: Az útmutató 3. lépése nem vonatkozik erre a projektre, ezért kihagyható

2. lépés: Hozzon létre egy Twilio fiókot

Ebben a lépésben a következőket fogjuk tenni:

1. Regisztráljon Twilio -fiókra
2. Gyors bevezetés a Twilio konzol hasznos részeibe

Regisztrálj:

Ebben a projektben a Twilio Whatsapp API -t fogjuk használni a python programunk és a Whatsapp összekapcsolásához. A Twilio API használatához először létre kell hoznunk egy fiókot a Twilio hivatalos weboldalán. A próbafiókhoz a Twilio 15 dollár ingyenes hitelt kínál számunkra.

Gyors bemutatkozás:

Miután létrehozott egy fiókot, a Twilio konzol legérdekesebb részei ehhez a projekthez a következők:

Irányítópult - Az irányítópulton láthatja a még hátralevő jóváírást, szerkesztheti a projekt nevét és megváltoztathatja a programozási nyelvet

Whatsapp alszakasz a Programozható SMS részben - A konzol Whatsapp részéből hozzáférhet a bot csatlakozási kódjához, a Whatsapp számához, amelyet a projektben fogunk használni a botunkkal való beszélgetéshez, valamint a webhook beállításához. Mindezekről további részleteket a következő lépések ismertetnek

3. lépés: Szerezze be az API -kulcsot a COVID 19 adatokhoz, filmekhez és TV -műsorokhoz

Az API -kulcs vagy az alkalmazás -programozási felület kulcsa olyan kód, amelyet a számítógépes alkalmazások továbbítanak. A program vagy alkalmazás ezután felhívja az API -t vagy az alkalmazásprogramozási felületet, hogy azonosítsa felhasználóját, fejlesztőjét vagy hívóprogramját egy webhelyhez.

API -t használunk a COVID 19 állapotról, filmekről és tévéműsorokról szóló legfrissebb információk megszerzéséhez. Az API eléréséhez szüksége van egy kulcsra, amely minden felhasználó számára személyes. Ebben a lépésben megkapjuk ezeket a kulcsokat

API -kulcs beszerzése a COVID 19 -adatokhoz:

• Jelentkezzen be vagy regisztráljon RapidAPI -fiókjába.
• Ezt követően menjen a Gramzivi COVID-19 API-jához
• Görgessen le az API konzol „Fejlécparaméterek” részéhez.
• Az API-kulcsnak láthatónak kell lennie az „X-RapidAPI-Key” mezőben.

Szerezze be az API -kulcsot filmekhez és tévéműsorokhoz:

• Jelentkezzen be vagy regisztráljon a TMDB -fiókjába
• Ezt követően lépjen a beállításhoz - API
• Görgessen le az „API -kulcs (v3 hitelesítés)” szakaszig
• Az API -kulcsnak láthatónak kell lennie alatta

Hozzon létre "config.py" fájlt

Most létrehozunk egy config.py fájlt az API kulcsaink tárolására. Ezekhez külön fájlt hozunk létre, mivel az API -kulcsok bizalmas információk, és ha megosztja a projektet, ne ossza meg az API -kulcsot.

• Hozzon létre egy új projektkönyvtárat
• Az újonnan létrehozott könyvtárban hozzon létre egy új fájlt "config.py" néven
• Szerkessze ezt a fájlt egy tetszőleges szerkesztővel (Sublime, Notepad ++), majd másolja le és cserélje ki a következő szöveget az előző lépésben kapott releváns információkkal:

session_key = "titkos" #Ez nem biztonságos.. de csak tesztelésre rendben van

rapid_api_key = "" api_key = ""

Mentse a fájlt

4. lépés: Csatlakoztassa a Python -t és a Twilio -t az Ngrok segítségével

Ebben a lépésben a következőket fogjuk tenni:

1. Töltse le a forráskódot
2. Futtassa a programot, és továbbítsa a helyi IP -t egy nyilvános címre az ngrok -on keresztül, hogy kérést küldhessünk hozzá
3. Állítsa be Twilio -fiókunkat, hogy továbbítsa a kérést a szerverünkre

Töltse le a bot forráskódját:

Töltse le az összes csatolt fájlt ebben a beállításban az utolsó lépésben létrehozott projektkönyvtárba.

A program végrehajtása:

Lépjen a forráskód könyvtárába a CMD/terminálban, és hajtsa végre a következő parancsot:

python szerver_main.py

Győződjön meg arról, hogy rendelkezik a "config.py" fájllal, amelyet az utolsó lépésben készítettünk, különben hibaüzenetet kap

A kimenetnek valahogy így kell lennie:

* Kiszolgáló lombik alkalmazás "server_main" (lusta betöltés)

* Környezet: gyártás FIGYELMEZTETÉS: Ez egy fejlesztő szerver. Ne használja éles üzemben. Használjon inkább éles WSGI szervert. * Hibakeresési mód: be * Futás: https://127.0.0.1:5000/ (Nyomja le a CTRL+C billentyűt a kilépéshez) * Újraindítás a stat -al * A hibakereső aktív! * Hibakereső PIN-kód: 740-257-236

Ez azt jelenti, hogy a szerver megfelelően működik a helyi hálózaton az 5000 -es porton. Annak érdekében, hogy ez a szerver a helyi hálózaton kívülről is elérhető legyen, az ngrok

Helyi IP továbbítása nyilvános címre az ngrok segítségével

Lépjen abba a könyvtárba, ahonnan letöltötte az ngrok -t CMD/terminálon keresztül, és hajtsa végre a következő parancsot:

ngrok http 5000

A kimenetnek valahogy így kell lennie:

ngrok by @inconshreveable (kilépéshez Ctrl+C)

A munkamenet állapota online A munkamenet lejár 7 óra 59 perc 2.3.35 verzió Verzió Egyesült Államok (us) Webes felület https://127.0.0.1:4040 Továbbítás _https://d44c955749bf.ngrok.io_ -> _https:// localhost: 5000_ Továbbítás _https://d44c955749bf.ngrok.io_ -> _https:// localhost: 5000_ Kapcsolatok ttl opn rt1 rt5 p50 p90 0 0 0.00 0.00 0.00 0.00

Másolja a HTTP linket a "Forwading" részből (csak az ngrok.io -ig). (Azért adtam hozzá a _ -t ebben a példában, hogy ne utasítsam, hogy hivatkozásként elfogja)

Állítsa be a Twilio -t, hogy az új címet használja a kiszolgáló kérésének továbbítására:

Most, hogy sikeresen továbbítottuk szerverünket, hogy nyilvánosan hozzáférhessünk, be kell állítanunk a Twilio -t úgy, hogy amikor a Twilio Whatsapp API használatával történik kérés, továbbítsuk a kérést a szerverünkre. Ehhez a következőket kell tennünk:

1. Lépjen a Twilio konzol Whatsapp részébe
2. Keresse meg a "Sanbox" alszakaszt
3. Az "AMIKOR ÜZENET JÖN" szövegmezőbe illessze be az ngrok HTTP linkjét az /sms kiterjesztéssel másolva (NE MÁSOLJA A _ -t az elején és a végén):

_https://d44c955749bf.ngrok.io/sms_

Most minden beállítva a chatbot számára. A következő lépésben tesztelhetjük, hogy minden megfelelően működik -e

5. lépés: Tesztelje alkalmazásunkat

Ebben a lépésben a következőket fogjuk tenni:

1. Csatlakozzon robotunkhoz a hozzáférési kód használatával
2. Próbálja ki alkalmazásunkat

Csatlakozzon robotunkhoz a hozzáférési kód használatával

Ebben a projektben a Twilio Whatsapp Sandbox számát fogjuk használni a Whatsapp botunkhoz. Ez a szám minden embernél más lesz. A számát így találhatja meg:

• Jelentkezzen be Twilio -fiókjába
• Lépjen a Twilio konzolra -> Whatsapp szakasz -> Homokozó
• Látni fogja a Twilio Sandbox számát a következő szöveggel:

Hívd meg barátaidat a homokozóba. Kérje meg őket, hogy küldjenek WhatsApp üzenetet a következő címre:

A Whatsapp biztonsági házirendje miatt mindenkinek, aki egy automatizált botmal szeretne beszélni a Whatsapp-on keresztül, kifejezetten fel kell iratkoznia egy kód használatával. A kódot úgy találhatja meg, hogy ugyanabban a részben nézi meg a Twilio homokozó számát a következő szöveggel:

Miután megszerezte Twilio Sandbox Whatsapp számát és engedélyezési kódját, a bot használatának megkezdéséhez lépjen a mobiltelefonjára, és tegye a következőket:

1. Mentse el a „Twilio Sandbox Whatsapp számát” a kapcsolattartójához a választott névvel (pl. CovBot)
2. Nyissa meg a Whatsapp alkalmazást, és küldje el a következő üzenetet a kapcsolattartónak:

csatlakozik

Ilyen üzenetet kell látnia:

Twilio Sandbox: Minden készen áll…

Ez azt jelenti, hogy kapcsolatba lépett a botjával, és készen áll arra, hogy megkérdezze azt

Próbálja ki alkalmazásunkat:

Ha szeretné kipróbálni a bot különböző tulajdonságait a csatlakoztatás után, küldje el a következő üzenetet a botnak:

Szia

A következő szöveget kell látnia:

Üdvözli a CoVbot!

Egyszerű chatbot, amely a COVID-19 legújabb frissítéseit nyújtja egyszerű, gyors és egyszerű módon. Mivel mindannyian karanténban vagyunk, a bot segítségével szórakoztató tevékenységeket lehet javasolni az otthoni időnk kihasználásához, miközben törekszünk saját, barátaink és családunk biztonságára. Reméljük, hogy élvezni fogja és hasznosnak találja! A kezdéshez küldjön 4 -et!

Most követheti a lehetőséget, hogy kipróbálja a bot különböző funkcióit.

EZ AZ! A Whatsapp Chatbot készen áll !!!! Gratulálunk

6. lépés: Hogyan működik és a jövőbeli fejlesztés:

Ez a rész azoknak szól, akik rendelkeznek valamilyen python programozási tapasztalattal. Ha nem, akkor kihagyhatja ezt a részt

Kódmagyarázat

Fő hurok:

Amikor Whatsapp üzenetet küld a Twilio számára, a Twilio API POST kérést küld a megadott szervernek. A szerver a lombik keretrendszerrel van megvalósítva, és így a lombik kérés objektum segítségével lekérhetjük a POST kérés során kapott adatokat. Az adatok (ebben az esetben a számok) alapján eldöntjük, hogy a felhasználó milyen lehetőséget választott, és megadjuk a megfelelő információkat

COVID adatok, filmek és tévéműsorok:

A COVID 19, a filmek és a TV -műsorok adatai egy API -ból származnak. A kérés python könyvtárát használom az adatok beszerzésére, majd JSON formátumba konvertálására. Aztán csak elemzem a releváns információkat. A Filmek és TV -műsorok esetében a véletlenszerű python -könyvtárat is használtam egy véletlenszerű TV -műsor és film kiválasztásához

Könyv részletei

A projektben használt könyvjavaslati algoritmus csak egy webkaparó. Nem találtam olyan API -t, amely véletlenszerű könyvet adna meg a részletekkel, ezért csak lekaparok egy webhelyet a BeautifulSoup4 használatával, és az lxml elemző segítségével kinyerem a könyv vonatkozó adatait

Az almenü részletei:

Az almenük végrehajtása kicsit bonyolultabb volt, mint a többi, mivel a Whatsapp üzenetek olyanok, mint az SMS-ek, ami egy állapot nélküli protokoll. Ennek megoldásához két technikát használtam:

1. Globális változók használata az üzenet állapotának megjegyzésére - Ez csak a COVID 19 alopcióra vonatkozik. Ebben az esetben, ha a felhasználó a "COVID 19 állapota az én országomban opciót" választja, a nem teljes_üzenet nevű globális változó értéke True, hogy jelezze, akkor továbbra is szükség van egy másik üzenetre az előző beállítás alapján. Ezután az elején van egy ellenőrzés, amely ellenőrzi, hogy az üzenet nem fejeződött -e be, ha így van, feltételezi, hogy az üzenet a COVID -adatok országneve, és továbbítja az információkat a megfelelő funkciónak, és a globális változó hiányos üzenetét állítja hamisra
2. A Twilio cookie -k és lombikmunkák használata - A cookie -kat és a lombik -munkameneteket a "Karanténtevékenység javaslata" almenüben használják az állapotosság megvalósításához, ahogyan manapság minden internetes webalkalmazás használja, de ahelyett, hogy emlékezne az olyan dolgokra, mint a felhasználóneve vagy vegye figyelembe a két szám közötti konverziót. Ha további információra van szüksége erről a részről, azt javasoltam, hogy olvassa el ezt a fantasztikus útmutatót a Twilio Cookies -ről, amelyet a Twilio csapat írt

Jövőbeli fejlesztések:

1. Használja ki a Python objektumorientáltságát és a tervezési mintákat a kód architektúra és a SZÁRÍTÁS javítása érdekében
2. Távolítsa el a globális változókat
3. A hibakezelés javítható
4. Az ngrok cím automatikus frissítése a kukorica és a Twilio CLI használatával
5. Kóddokumentáció

7. lépés: Záró megjegyzések

Remélem mindenkinek tetszik ez a projekt. Ez az első tanulságos, így ha valami nem világos, vagy további magyarázatra szorul, tudassa velem a megjegyzés rovatban, és segíthetek. Ha ezt a projektet más technikával vagy szolgáltatáslistával készítette, ossza meg azt is