Installing the Magento 2 plugin

home-magento2.png

Download the Extension

The Sendinblue extension for Magento 2 let you manage Magento email and SMS functionality.

Before you start

You will need to gather the following information prior to installation and use:

  • Sendinblue account credentials
  • Sendinblue API v3 key (instructions below)
  • Magento 2 website root directory access
  • Magento 2 website admin panel access

To use all extension features, please ensure that your Sendinblue account is validated to send email and SMS messages from the Sendinblue Campaigns and Transactional platforms.

To send SMS messages, please purchase SMS credits in your Sendinblue account by navigating to My plan > SMS credits.

Installing the extension

There are two methods for installing the Sendinblue extension for Magento:

Method 1: Install the extension using a zipped file:

  1. Download the Sendinblue extension from the Magento Marketplace
  2. Unzip the file
  3. In your Magento 2 root directory, create the folder app/code/Sendinblue/Sendinblue
  4. Move the extension’s unzipped files and folders to the new folder in your root directory
  5. In the command line (using “cd”) navigate to your Magento 2 root directory
  6. Run the following commands in order:

sudo bin/magento module:enable Sendinblue_Sendinblue
sudo bin/magento setup:di:compile
sudo bin/magento setup:upgrade

Your extension is now installed and accessible from the left navigation menu in your Magento 2 back office: Content > Sendinblue settings.

Method 2: Install the extension using the MagentoAdmin interface:

  1. Add the Sendinblue extension from Magento Marketplace
  2. Go to System > Web Setup Wizard
    Magento_EN_1-0.png
  3. Go to System Configuration
    Magento_EN_1-1.png
  4. Input your public access key and private access key
  5. Click Save Config
    Magento_EN_1-2.png
  6. Go to Component Manager
    Magento_EN_1-3.png
  7. The Sendinblue extension should now be included in your list of available extensions
    Magento_EN_1-4.png
  8. Click Install and follow the steps on-screen
    Magento_EN_1-5.png

Installation troubleshooting

If you experience any issues during installation, please follow these troubleshooting steps and re-try installation before contacting Sendinblue or Magento support teams. 

  1. Empty the Magento cache.
  2. Log off and log back on as Magento administrator
  3. Check Stores > Configuration > Advanced. The "Sendinblue_Sendinblue" module must be activated.

How to use the Magento 2 extension

❗️ Important
To use the Magento extension, you must first create a Sendinblue account and make sure you have added and validated a sender address.

To activate the extension, you need the API key that you will find in your Sendinblue account:

  1. Click your name on the top-right side of the screen
  2. Go to SMTP & API
  3. Copy the API v3 key which is compatible with plugins
    api_v3.png
  4. After you have copied the API key, login to your Magento website
  5. Go to the Sendinblue extension
    Magento_EN_2-2.png
  6. On the About Sendinblue tab, activate the Sendinblue module by selecting "Yes" and pasting the API key into the Sendinblue extension settings
    Magento_EN_2-3.png

Automatically synchronize contacts from your Magento website with your Sendinblue account

If you want to use Sendinblue to manage subscribers from your Magento website, select Yes.

Magento_EN_2-4.png

Once this option has been selected, a Sendinblue subscription form will be activated on the home page of your Magento website.

New subscribers to your e-store newsletter will now automatically be added to the contacts database in your Sendinblue account. You can select the list to which new subscribers will be saved, as well as the confirmation email template that will automatically be sent to confirm their subscription.

💡 Good to know
To send subscription confirmation emails, you must make sure that your SMTP account for transactional emails is activated. Otherwise, no confirmations will be sent. If your SMTP account is not automatically activated, you can contact our support team for immediate assistance.

What data is synchronized?

If a contact has subscribed via the website default footer, only the EMAIL field will be synchronized.

If a contact has created a Magento account and subscribed to your newsletter, the following fields will be synchronized:

Attribute

Description

Type of attribute

EMAIL

Email of the contact

TEXT

NAME

First name of the contact

TEXT

SURNAME

Last name of the contact

TEXT

CIV

Civility of the contact

TEXT

BIRTHDAY

Date of birth of the contact

DATE

PS_LANG

Language of the contact

TEXT

COMPANY

Company of the contact

TEXT

SMS

Phone number of the contact

TEXT

GROUP_ID

Group ID, relevant for multistore only

TEXT

STORE_ID

Store ID, relevant for multistore only

TEXT

DEFAULT_GROUP_ID

Groups the contact belongs to

TEXT

CLIENT

Your Sendinblue account will display "1" as a value when the contact is a client.

NUMBER

Automatically track sales with Sendinblue

Check this option to automatically import details of your customers' orders into your Sendinblue database. This will show you the sales generated by your customers in the last X days. It may then be used to segment your database based on sales (e.g. provide a special offer to your VIP customers).

Magento_EN_2-5.png

Optimize the deliverability of your transactional emails using Sendinblue SMTP

❗️ Important
You must make sure that your Sendinblue SMTP account has been activated.

By selecting Yes to activate Sendinblue SMTP, your transactional emails (order confirmations, password resets, etc.) will be sent via the Sendinblue SMTP. 

Magento_EN_2-6.png

Send SMS/text messages 

Sendinblue also lets you send SMS directly from your Magento back office, such as:

  • order confirmation SMS
  • order shipment SMS
  • campaign SMS, e.g. countdown to the sales.

When you send campaign SMS to your subscribers/customers from this interface, the campaign will automatically be created in your Sendinblue account. You can then check your campaign report (SMS delivered, opened, clicked on, etc.) from your Sendinblue account. If you only send your campaign to one contact, it will not be created in your Sendinblue account.

You can personalize your SMS with attributes that exist in your Sendinblue database as shown in the screenshot below, e.g. {first_name}. 

Magento_EN_2-7.png

If you would like to create a targeted segment to use in an SMS campaign, it must be created within your Sendinblue account. Within the back office of your Magento website, the possible targets are limited to:

  • all your Magento contacts
  • Magento contacts subscribed to your newsletter
  • a single contact

Track contact synchronization  

When someone subscribes to your newsletter on your Magento website, a green tick will be displayed under each of the statuses shown at the top of the table for this contact ("Subscribed to Magento", "Subscribed to Sendinblue", "Sendinblue SMS Status" - whether or not the contact has agreed to be contacted by SMS).

Magento_EN_2-8.png

When someone places an order on your website, only "Subscribed to Sendinblue" and "Sendinblue SMS Status" will be ticked.

You can subscribe and unsubscribe Sendinblue contacts by clicking on the Sendinblue status, which will change from green to red or vice versa. This is equivalent to blacklisting or unblacklisting in your Sendinblue account. You cannot do this for the Magento status.

To synchronize your Sendinblue contacts with Magento, you must run a CRON or make sure that the script runs automatically every day. It must be synchronized at least once a day.

Magento_EN_2-9.png

🤔 Have a question?

If you have a question, feel free to contact our support team by creating a ticket from your account. If you don't have an account yet, you can contact us here.