Pymâssoir
1.0.0
Pymessager est une API Python pour Facebook Messenger et un exemple de projet pour montrer comment développer un chatbot sur Facebook Messenger.
Les tutoriels complets sont sur le développement d'un bot Facebook à l'aide de Python et du chatbot: de 0 à 1 où vous pouvez trouver des informations plus détaillées à configurer et à développer.
Pour installer Pymessager, exécutez simplement:
$ pip install pymessagerou installer à partir du référentiel:
$ git clone [email protected]:enginebai/PyMessager.git
$ cd PyMessager
$ pip install -r requirements.txt from pymessager . message import Messager , ... # something else you needVous pouvez initialiser un client Messager via un jeton d'accès Facebook à partir de la console du développeur:
from pymessager . message import Messager
client = Messager ( config . facebook_access_token )Le code suivant est utilisé pour construire un récepteur de messages, il y a trois étapes principales pour préparer votre bot:
@ app . route ( API_ROOT + FB_WEBHOOK , methods = [ "GET" ])
def fb_webhook ():
verification_code = 'I_AM_VERIFICIATION_CODE'
verify_token = request . args . get ( 'hub.verify_token' )
if verification_code == verify_token :
return request . args . get ( 'hub.challenge' ) @ app . route ( API_ROOT + FB_WEBHOOK , methods = [ 'POST' ])
def fb_receive_message ():
message_entries = json . loads ( request . data . decode ( 'utf8' ))[ 'entry' ]
for entry in message_entries :
for message in entry [ 'messaging' ]:
if message . get ( 'message' ):
print ( "{sender[id]} says {message[text]}" . format ( ** message ))
return "Hi" if __name__ == '__main__' :
context = ( 'ssl/fullchain.pem' , 'ssl/privkey.pem' )
app . run ( host = '0.0.0.0' , debug = True , ssl_context = context ) Il existe plusieurs types de message: text , image , quick replies , button template ou generic template . L'API fournit différentes classes pour générer le modèle de message.
Envoyez un texte simple ou une image à un destinataire, assurez-vous simplement que l'URL de l'image est un lien valide.
client . send_text ( user_id , "Hello, I'm enginebai." )
client . send_image ( user_id , "http://image-url.jpg" ) La classe QuickReply(title, payload, image_url, content_type) définit un boutons actuels à l'utilisateur en réponse à un message.
| Paramètre | Description | Requis |
|---|---|---|
title | Le titre du bouton | Y |
payload | La chaîne de charge utile cliquez | Y |
image_url | L'URL de l'image icône | N |
content_type | TEXT ou LOCATION | Y |
client . send_quick_replies ( user_id , "Help" , [
QuickReply ( "Projects" , Intent . PROJECT ),
QuickReply ( "Blog" , Intent . BLOG ),
QuickReply ( "Contact Me" , Intent . CONTACT_ME )
]) La classe ActionButton(button_type, title, url, payload) définit le modèle de bouton qui contient une pièce jointe de texte et de boutons pour demander l'entrée de l'utilisateur.
| Paramètre | Description | Requis |
|---|---|---|
button_type | WEB_URL ou POSTBACK | Y |
title | Le titre du bouton | Y |
url | Le lien | Uniquement si button_type est url |
payload | La chaîne de charge utile cliquez | Seulement si button_type est POSTBACK |
client . send_buttons ( user_id , "You can find me with below" , [
ActionButton ( ButtonType . WEB_URL , "Blog" , "http://blog.enginebai.com" ),
ActionButton ( ButtonType . POSTBACK , "Email" , Intent . EMAIL )
]) La classe GenericElement(title, subtitle, image_url, buttons) définit un carrousel horizontal défilable d'éléments, chacun composé d'une pièce jointe d'image, d'une description courte et de boutons pour demander l'entrée de l'utilisateur.
| Paramètre | Description | Requis |
|---|---|---|
title_text | Le titre principal du message | Y |
subtitle_text | Le sous-titre du message, laissez-le vide si vous n'en avez pas besoin | N |
button_list | La liste d' ActionButton | Y |
project_list = []
for project_id , project in projects . items ():
project_list . append ( GenericElement (
project [ "title" ],
project [ "description" ],
config . api_root + project [ "image_url" ], [
ActionButton ( ButtonType . POSTBACK ,
self . _get_string ( "button_more" ),
# Payload use Intent for the beginning
payload = Intent . PROJECTS . name + project_id )
]))
client . send_generic ( user_id , project_list )Avant que votre chatbot ne commence à recevoir des messages, vous devez vous abonner à l'application à votre page chatbot. Pour vous abonner à une page, appelez-le:
client . subscribe_to_page ()Le texte de salutation s'affichera lors de la première fois que vous ouvrez ce chatbot sur mobile uniquement. La charge utile est le déclencheur lorsque les utilisateurs cliquent sur le bouton "Démarrer".
client . set_greeting_text ( "Hi, this is Engine Bai. Nice to meet you!" )
client . set_get_started_button_payload ( "HELP" ) # Specify a payload string. N'hésitez pas à soumettre des rapports de bogues ou des demandes de fonctionnalités et assurez-vous de lire les directives de contribution avant d'ouvrir un problème.
feature / bug ).En savoir plus sur la contribution.
The MIT License (MIT)
Copyright © 2017 Engine Bai.
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.
