Bot:Guide/approved services: Difference between revisions
Content deleted Content added
No edit summary |
No edit summary |
||
Line 1:
'''Bot:Guide/approved services''' lists all service functions that service bots can execute on behalf of authorized users. When a user sends an email to a service bot, the bot reads this page to identify which function to run and which parameters to extract.
{{Section separator}}
== List of approved services ==
=== get_pdf ===
==== Description ====
* Converts a specified MediaWiki page into a PDF document and emails it back to the sender as an attachment.
* The user provides the title of the wiki page they want as a PDF.
* Pay special attention to terms wrapped in brackets like <nowiki>[[term]]</nowiki> or written in ALL CAPS, as these often indicate the page title.
==== Required parameters ====
* '''page_title''' — the name of the wiki page to convert (e.g. "Combined ratio", "Internal:Teams/Group tax department"). The bot normalizes the title to match the wiki page name.
==== Optional parameters ====
None.
==== Trigger phrases ====
* "send me a PDF of..."
* "print this page..."
* "download the page..."
* "get a PDF of..."
* "export this page to PDF..."
* "can I get a PDF for..."
* "email me the PDF of..."
==== Examples ====
'''1. Simple page request:'''
<pre>
Subject: PDF of Combined ratio
Body: Hi, can you send me a PDF of the Combined ratio page?
</pre>
→ page_title: Combined ratio
'''2. Bracketed page title:'''
<pre>
Subject: Print page
Body: Hi, please send me a PDF of [[Internal:Teams/Group tax department]].
</pre>
→ page_title: Internal:Teams/Group tax department
'''3. Informal request:'''
<pre>
Subject: Download page
Body: Could I get a PDF for the LOSS RATIO page? Thanks!
</pre>
→ page_title: Loss ratio
{{Section separator}}
== Fallback ==
=== Required parameters missing ===
When the bot identifies the function but required parameters are missing, it replies with the following template. The bot replaces <nowiki>[first_name]</nowiki>, <nowiki>[function_name]</nowiki>, <nowiki>[missing_parameters]</nowiki>, and <nowiki>[bot_name]</nowiki> with actual values.
<pre>
Hello [first_name],
Thank you for your email. I identified your request as "[function_name]", but I'm missing the following required information:
[missing_parameters]
Could you reply with the missing details so I can proceed?
Best regards,
[bot_name]
</pre>
=== Rejected ===
When the bot cannot match the user's request to any approved function, it replies with the following template. The bot replaces <nowiki>[first_name]</nowiki> and <nowiki>[bot_name]</nowiki> with actual values.
<pre>
Hello [first_name],
Thank you for your email. I wasn't able to match your request to any of my available services.
Here is what I can currently do:
- Convert a wiki page to PDF and email it back to you
Could you rephrase your request, or contact your administrator for help?
Best regards,
[bot_name]
</pre>
| |||