Bot:Guide/approved services
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.
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 [[term]] 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:
Subject: PDF of Combined ratio Body: Hi, can you send me a PDF of the Combined ratio page?
→ page_title: Combined ratio
2. Bracketed page title:
Subject: Print page Body: Hi, please send me a PDF of [[Internal:Teams/Group tax department]].
→ page_title: Internal:Teams/Group tax department
3. Informal request:
Subject: Download page Body: Could I get a PDF for the LOSS RATIO page? Thanks!
→ page_title: Loss ratio
Fallback
Required parameters missing
When the bot identifies the function but required parameters are missing, it replies with the following template. The bot replaces [first_name], [function_name], [missing_parameters], and [bot_name] with actual values.
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]
Rejected
When the bot cannot match the user's request to any approved function, it replies with the following template. The bot replaces [first_name] and [bot_name] with actual values.
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]