Skip to content
Kibi Connect
Manual Kibi Connect

How does a custom module send emails and PDFs?

Updated Reading time: 3 min

On this page

Custom modules can pass on results: generate a report as a PDF, download it, attach it to an entry, or send it via email. For example: In the defect reporter, an employee reports a faulty radiator. The module generates a report as a PDF from this and sends it to the building technician, whom the administration has entered in the module settings.

Info

What a module sends and when is determined by the module itself. The administration decides whether it may also reach addresses outside the platform.

Reports as PDF#

A module creates a PDF from its data, for example a defect report, an inspection protocol, or an evaluation. Depending on the module, you can then:

  • download the PDF to save or print it,

  • attach it to the entry so that it remains with the report and is visible to everyone who is allowed to see the entry,

  • send it via email, as an attachment to platform users or to shared addresses.

A PDF has a maximum of 50 pages. It contains text, tables, and images from the module, but no content from the internet.

Emails from a module#

A module sends emails to up to 20 recipients at once. Recipients are people on the platform, groups, or, if the administration allows it, external email addresses.

  • Sender is always the platform under the name of your company. Below each message it says: Sent by <person> via the module "<module>" in <company>.

  • Replies go to the person who triggered the email, if the module provides for this.

  • Each recipient receives their own message. No one sees the addresses of the others, not even the addresses of colleagues.

  • Attachments: up to 5 files, together at most 15 MB, for example the created PDF, photos for the report, or tables.

  • People as recipients: The module only reaches people you can see yourself in the directory.

  • Groups as recipients: The module writes to all members of a group that you can see yourself. You yourself do not receive a copy. A group counts as one recipient, across all groups of one email it is at most 50 people. If there are more, the email is not sent.

You can see which modules send emails in the module itself: Click on the shield icon at the top right in the row above the module. There it states whether the module can send emails to people on the platform and, if applicable, also externally. More on this under How do I open my own module?.

Allow emails to external addresses#

A module may write to people on the platform without approval if it states this in its description. For external addresses, such as an external building technology company, your approval is required. This is set by people who are allowed to edit the module:

Open the module in the Module Studio: Administration, under Platform the entry Modules, tab Own, then the module.

Switch to the Settings tab at the top, then to General, and scroll to the Emails from the module section.

Enable Allow external recipients.

Under Only to these domains, enter the domains the module is allowed to write to, one per line, for example example.de. Subdomains are included.

Click Save.

Warning

Without a domain, no external recipient is allowed. If the module should be allowed to write to any address, enable Allow all domains and confirm the prompt. Only do this if you trust the module and everyone who uses it: the module then writes on behalf of your company, with content that people enter in the module.

  • Guests cannot trigger emails to external addresses.

  • If the module does not state in its description that it sends externally, the approval only takes effect with a version that states this.

  • The approval belongs to your installation and is retained during module updates.

Limits#

What

Limit

Recipients per email

20

People via groups per email

50

Attachments per email

5 files, 15 MB total

File types as attachments

PDF, PNG, JPG, CSV, XLSX, DOCX, ODS, ODT, ODP, ICS, TXT

Emails per person and module

30 per hour

Emails per company

500 in 24 hours

External recipients per company

200 in 24 hours

Pages per PDF

50

Tracking Shipments#

Under Emails from the module, you will find the shipments of the last 7 days: how many emails were sent to how many people on the platform and to external addresses, and how many deliveries failed.

Info

Kibi only stores these numbers for shipments, not subjects, contents, or addresses.