1 General
2 Installing
- 2.1 Configuration
  - 2.1.1 Configuration actions
  - 2.1.2 Configuration fields
- 2.2 Webhooks
  - 2.2.1 Webhook setup in Maileon
  - 2.2.2 Webhook setup in FundraisingBox
3 Available permissions
4 Transaction data
- - 4.1.1 fundraisingbox_donation_v1
- 4.2 Custom fields
5 Syncing all existing subscriber from FundraisingBox to Maileon

General

This extension is responsible for handling subscriber and donation information between Maileon and the FundraisingBox platform (https://fundraisingbox.com )

Installing

You can find this extension in your Maileon account settings once enabled by the Maileon service team.

Maileon account settings

Plugins view

Configuration

The plugin setup process is handled in your Maileon account.

Configuration actions

There are a few options after you filled out the form.

Save settings

When you click the Save settings button, we test your configuration to make sure it’s valid. After the successful test you can either close the window or press the initial sync button.

Initial sync

After successful configuration save, you can sync your existing contacts from FundraisingBox to Maileon by pressing this button. This action may take a minute or two, so after its successful we’ll send an email notification about it to the Notification email.

Configuration fields

Field name	Description
Fundraisingbox Client ID	You can find your client id in your FundraisingBox account by clicking on your profile.
Fundraisingbox Token	To receive your api token, you need to manually ask FundraisingBox support.
Maileon API Key	The API Key can be created and viewed in the Maileon account under "Settings" → "API Keys" and ensures the connection to your account. Make sure this API key is only used by this integration.
Initial Sync Permission	Contacts created by initial sync functionality.
Initial Sync DOI process	You can choose if the mass synced contacts should start the DOI process.
Initial Sync DOI key	The key of the mailing that should be triggered with the DOI process for the mass synced contacts (if active)
Live Sync Permission	Permission for contacts created by the plugin on the fly.
Live Sync DOI process	You can decide if Maileon should start the DOI process for new contacts coming from FundraisingBox.
Live Sync DOI Key	The key of the mailing that should be triggered with the DOI process for new contacts (if active)
Notification email	An email address we can use to send notifications for about the plugin activity.

Webhooks

This plugin works based on webhooks both in Maileon and FundraisingBox.

Webhook setup in Maileon

In Maileon you should see two webhooks related to the plugin.

Action	Events	Webhook example setup

Action	Events	Webhook example setup
Contact unsubscribes through Maileon	unsubscription
Contact accepts Double Opt In	doi

Currently the plugin creates the webhooks, but you need to manually add the JSON information to it. (as shown in the example setup, checkbox part).

Webhook setup in FundraisingBox

To send contacts and transactions to Maileon, the plugin needs webhooks on FundraisingBox side too.

Currently there is no way to create the webhook as a user or through api, which means you need to ask FundraisingBox support to create the webhooks.

Webhook configuration should look like this:

Event	Webhook type	Url

Event	Webhook type	Url
Donation	JSON webhook	https://fundraisingbox-xsic.maileon.com/fubox/api/donation?cid={{fundraisingbox_client_id&fid={{fundraisingbox_form_id}}&maid={{maileon_account_id}}

Available permissions

None: No permission. The contact will not receive newsletters.
Single Opt-in: Permission was simply granted, e.g. by entering an email address in a form. This method technically allows the contact to receive newsletters, but does not ensure that the email address belongs to the person who entered it.
Double Opt-in: With this permission, a confirmation email with a confirmation link is sent to the email address. Only when the link in the mail has been clicked and thus the interest in the entry has been confirmed, the contact can be sent.
Double Opt-in Plus: Double opt-in including consent for single user tracking. Please note: Without individual user tracking, no openings, clicks, etc. may be traced back to individual users and significant data for evaluating newsletter performance is missing. newsletter performance is missing.

Transaction data

Keys and data types of transaction object

fundraisingbox_donation_v1

Key	Data

Key	Data
`donation.id`	integer
`fubox_project_id`	integer
`fubox_donation_message`	string
`fubox_source_name`	string
`fubox_source_promotion_code`	string
`fubox_type_promotion_code`	string
`amount`	float
`currency`	string
`receipt_status`	string
`public_name`	string
`public_message`	string

Custom fields

Field	Data type	Description

Field	Data type	Description
`FundraisingBoxPersonId`	integer	The person id in FundraisingBox
`FundraisingBoxAccountId`	integer	The FundraisingBox account id
`FundraisingBoxDonationCount`	integer	The total donation count for a person
`FundraisingBoxEmailId`	integer	The id of the main email address for a person
`phone`	string	The phone number provided during the donation

Syncing all existing subscriber from FundraisingBox to Maileon

All subscribers can be transferred to Maileon. This is done in a background process. You will need to provide an email address to which a notification will be sent at the end of the import. The contacts will be created in Maileon with the permission selected in the Initial sync permission field. DOI process is handled based on Initial DOI process field (enabling it is not recommended for bulk imports). Once the import is complete, an email notification will be sent.

FundraisingBox

General

Installing

Configuration

Configuration actions

Save settings

Initial sync

Configuration fields

Fundraisingbox Client ID

Fundraisingbox Token

Maileon API Key

Initial Sync Permission

Initial Sync DOI process

Initial Sync DOI key

Live Sync Permission

Live Sync DOI process

Live Sync DOI Key

Notification email