{"id":1303,"date":"2017-08-11T14:47:20","date_gmt":"2017-08-11T13:47:20","guid":{"rendered":"https:\/\/help.cirrus-shield.com\/docs\/user-guide\/integrations\/sendinblue\/"},"modified":"2023-09-16T15:48:34","modified_gmt":"2023-09-16T14:48:34","slug":"sendinblue","status":"publish","type":"docs","link":"https:\/\/help.cirrus-shield.com\/en\/docs\/admin-guide\/plugins\/sendinblue\/","title":{"rendered":"Brevo (previously Sendinblue)"},"content":{"rendered":"\n<p>Brevo is a <strong>marketing automation tool&nbsp;<\/strong>that allows you to send emailing campaigns to a list of leads or contacts. With its connector to Cirrus Shield, the following events are sent back from Brevo to Cirrus Shield: <strong>bounce, unsubscribe, email opened<\/strong>, <strong>email clicked.<\/strong><\/p>\n\n\n\n<p>Pour fonctionner correctement avec Cirrus Shield, le connecteur Brevo suppose la pr\u00e9sence des objets et des champs suivants dans votre mod\u00e8le de donn\u00e9es:<\/p>\n\n\n\n<figure class=\"wp-block-table is-style-stripes\"><table><tbody><tr><td><strong>Object Technical Name<\/strong><\/td><td><strong>Field Technical Name<\/strong><\/td><td><strong>Comment<\/strong><\/td><\/tr><tr><td>Contact<\/td><td>Email<\/td><td><\/td><\/tr><tr><td>Contact<\/td><td>Email_Opt_Out<\/td><td><\/td><\/tr><tr><td>Contact<\/td><td>Invalid_Email<\/td><td><\/td><\/tr><tr><td>Lead<\/td><td>Email<\/td><td><\/td><\/tr><tr><td>Lead<\/td><td>Email_Opt_Out<\/td><td><\/td><\/tr><tr><td>Lead<\/td><td>Invalid_Email<\/td><td><\/td><\/tr><tr><td>Campaign<\/td><td>Name<\/td><td><\/td><\/tr><tr><td>Campaign<\/td><td>SIB_Campaign_ID<\/td><td><\/td><\/tr><tr><td>Campaign<\/td><td>OwnerId<\/td><td><\/td><\/tr><tr><td>Campaign_Member<\/td><td>Campaign<\/td><td><\/td><\/tr><tr><td>Campaign_Member<\/td><td>Member<\/td><td><\/td><\/tr><tr><td>Campaign_Member<\/td><td>SIB_Campaign_Member_ID<\/td><td><\/td><\/tr><tr><td>Campaign_Member<\/td><td>OwnerId<\/td><td><\/td><\/tr><tr><td>Campaign_Member<\/td><td>Email_Opened<\/td><td><\/td><\/tr><tr><td>Campaign_Member<\/td><td>Email_Clicked<\/td><td><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n<section class=\"fw-main-row \">\n<div class=\"fw-container\">\n<div class=\"fw-row\">\n<div class=\"fw-col-xs-12\">\n<p>This section provides you with the required <strong>configurations<\/strong> to allow the Brevo connectors to function with Cirrus Shield (only the <a style=\"color: #009551;\"> administrator system<\/a> can do the configuration).<\/p>\n<p>The following configurations assume that your environment has a standard configuration and that the fields in the above table were not deleted.<\/p>\n<div class=\"fw-divider-space\" style=\"padding-top: 25px;\">\u00a0<\/div>\n<div class=\"fw-accordion\">\n<h3 class=\"fw-accordion-title\"><a style=\"color: #ff8a00;\"><b>Campaign Configuration<\/b><\/a><\/h3>\n<div class=\"fw-accordion-content\">\n<p>&#8211; Add a new <a style=\"color: #009551;\"><b>Text<\/b><\/a> field and put <b>\u201cSIB_Campaign_ID\u201d<\/b> in the Name field (it should be exactly the same).<\/p>\n<p>&#8211; Check the <a style=\"color: #009551;\"><b>External ID<\/b><\/a> and the <a style=\"color: #009551;\"><b>Unique<\/b><\/a> checkboxes.<\/p>\n<p>&#8211; Go to the <a style=\"color: #009551;\"><b>Page Designer<\/b><\/a> tab.<\/p>\n<p>&#8211; Add the <b>&#8220;SIB_Campaign_ID&#8221;<\/b> field into your campaigns page.<\/p>\n<\/div>\n<h3 class=\"fw-accordion-title\"><a style=\"color: #ff8a00;\"><b>Campaign Member Configuration<\/b><\/a><\/h3>\n<div class=\"fw-accordion-content\">\n<p>&#8211; Add a new <a style=\"color: #009551;\"><b>Text<\/b><\/a> field and put<b> \u201cSIB_Campaign_Member_ID\u201d<\/b> in the Name field (it should be exactly the same).<\/p>\n<p>&#8211; Check the <a style=\"color: #009551;\"><b>External ID<\/b><\/a> and the <a style=\"color: #009551;\"><b>Unique<\/b><\/a> checkboxes.<\/p>\n<p>&#8211; Create two checkboxes with the corresponding Name fields: <a style=\"color: #009551;\"><b>\u201cEmail_Clicked\u201d<\/b><\/a> and <a style=\"color: #009551;\"><b>\u201cEmail_Opened\u201d<\/b><\/a>.<\/p>\n<p>&#8211; Go to the <a style=\"color: #009551;\"><b>Page Designer<\/b><\/a> tab.<\/p>\n<p>&#8211; Add the <b>&#8220;SIB_Campaign_Member_ID&#8221;<\/b>, <b>&#8220;Email_Clicked&#8221;<\/b>, and <b>&#8220;Email_Opened&#8221;<\/b> fields into your campaign members\u2019 page.<\/p>\n<\/div>\n<h3 class=\"fw-accordion-title\"><a style=\"color: #ff8a00;\"><b>Brevo Configuration<\/b><\/a><\/h3>\n<div class=\"fw-accordion-content\">\n<p>First of all, create an account in &#8220;<a href=\"https:\/\/www.brevo.com\/\">Brevo<\/a>&#8220;.<\/p>\n<p><b>4 steps to synchronize the information between Cirrus Shield and Brevo:<\/b><\/p>\n<p><a style=\"color: #ff8a00;\"><b>First step, configure the Brevo plugin in Cirrus Shield:<\/b><\/a><\/p>\n<p>1- Go to <b>Setup<\/b> and click on the <b>Plugin<\/b> tab.<\/p>\n<p>2- Click on <b>New<\/b> and select <b>Brevo<\/b>.<\/p>\n<p>3- Click on <b>install<\/b>.<\/p>\n<p>4- Once the plugin is installed, click on <b>Details<\/b> next to Brevo plugin.<\/p>\n<p>5- Click on <b>Edit<\/b>.<\/p>\n<p>6- Copy the <b>API KEY<\/b> present in your Brevo account. To do so, log in and click on <b>API &amp; Forms<\/b> tab and then click on <b>Manage your keys<\/b>. Copy the &#8220;API Key&#8221; v2 and put it in the <b>&#8220;Authentication ID&#8221;<\/b> field present in Cirrus Shield.<\/p>\n<p>7- Save the modifications.<\/p>\n<p><a style=\"color: #ff8a00;\"><b>Second step, choose which object you want to upload in the contact list of Brevo:<\/b><\/a><\/p>\n<p>1- Click on <b>Details<\/b> next to Brevo plugin.<\/p>\n<p>2- Go to the &#8220;Plugin Component&#8221; section.<\/p>\n<p>3- Click on <b>Edit<\/b> next to &#8220;Upload to Brevo&#8221;.<\/p>\n<p>4- Select the objects you want to upload in Brevo. In most case, it will be the <b>Lead<\/b> object or the <b>Contact<\/b> object.<\/p>\n<p>5- Click save.<\/p>\n<p><a style=\"color: #ff8a00;\"><b>Third step, map the Cirrus Shield fields with the Brevo fields:<\/b><\/a><\/p>\n<p>1- Click on <b>&#8220;Upload to Brevo&#8221;.<\/b><\/p>\n<p>2- Go to the <b>&#8220;Component Mapping Fields&#8221;<\/b> and click on <b>Edit<\/b>.<\/p>\n<p>3- Map the Brevo fields with the Cirrus Shield fields.<\/p>\n<p>4- Click save.<\/p>\n<p><a style=\"color: #ff8a00;\"><b>Fourth step, add the profiles access to the buttons that were added on each of the selected objects:<\/b><\/a><\/p>\n<p>1- Click on <b>Objects<\/b> in the configuration menu.<\/p>\n<p>2- On each of the objects on which you added Brevo go to &#8220;Custom Buttons&#8221; tab.<\/p>\n<p>3- Click on &#8220;Details&#8221; next to the &#8220;Upload to Brevo&#8221; button.<\/p>\n<p>4- Click on the Profiles tab then edit.<\/p>\n<p>5- Add all profiles to which you wish to give access to the button then click save.<\/p>\n<p><a style=\"color: #ff8a00;\"><b>Last step, set up the web hook present in Brevo:<\/b><\/a><\/p>\n<p>1- Click on this link: <a href=\"https:\/\/my.brevo.com\/advanced\/webhook\/\" target=\"_blank\" rel=\"noopener noreferrer\">Web Hook.<\/a><\/p>\n<p>2- Log in to your Brevo account.<\/p>\n<p>3- Click on <b>Add a new Webhook<\/b>.<\/p>\n<p>4- Check the &#8220;Delivered&#8221;, &#8220;Opened&#8221;, &#8220;Clicked&#8221;, &#8220;Marked as Spam&#8221;, &#8220;Hard Bounce&#8221; and &#8220;Unsubscribed&#8221; boxes.<\/p>\n<p>5- Paste <b>this link<\/b> in the URL section field: https:\/\/sib.cirrus-shield.net\/v2\/index.php?un=&amp;pw=<\/p>\n<p>(for old versions of CS where the campaign member contact is a simple lookup field, please use: https:\/\/sib.cirrus-shield.net\/index2.php?un=&amp;pw=)<\/p>\n<p>6- Note that this URL should contain the username and password of Cirrus-shield which are set after the equals signs (un for username and pw for password).<\/p>\n<p>7- But since some special characters can\u2019t be set directly in a URL, a string encoding should be done. Thus head to <a href=\"https:\/\/www.urlencoder.org\/\">www.urlencoder.org <\/a>an online service to encode your username and password and paste each in its respective field in the web hook URL.<\/p>\n<p>8- Click add.<\/p>\n<\/div>\n<h3 class=\"fw-accordion-title\"><a style=\"color: #ff8a00;\"><b>Lead or Contact Configuration<\/b><\/a><\/h3>\n<div class=\"fw-accordion-content\">\n<p>&#8211; Create two checkboxes with the corresponding Name fields: <a style=\"color: #009551;\"><b>&#8220;Email_Opt_Out&#8221;<\/b><\/a> and <a style=\"color: #009551;\"><b>&#8220;Invalid_Email&#8221;<\/b><\/a>.<\/p>\n<p>&#8211; Go to the <a style=\"color: #009551;\"><b>Page Designer<\/b><\/a> Tab.<\/p>\n<p>&#8211; Add the <b>&#8220;Email_Opt_Out&#8221;<\/b> and <b>&#8220;Invalid_Email&#8221;<\/b> fields into your lead&#8217;s or contact&#8217;s page.<\/p>\n<\/div>\n<\/div>\n<div class=\"fw-divider-space\" style=\"padding-top: 25px;\">\u00a0<\/div>\n<p><strong>The configurations is now finished<\/strong>. To understand how to use the Brevo plugin, please go to :<a href=\"https:\/\/help.cirrus-shield.com\/en\/docs\/user-guide\/integrations\/sendinblue\/\"> User Guide &#8211; Brevo Integration<\/a><\/p>\n<\/div>\n<\/div>\n<\/div>\n<\/section>\n<p><!-- 80ac0b08ff8c9cd042adff9e7211e39d --><\/p>","protected":false},"author":1,"featured_media":0,"parent":1363,"menu_order":0,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_et_pb_use_builder":"","_et_pb_old_content":"","_et_gb_content_width":"","footnotes":""},"doc_tag":[],"class_list":["post-1303","docs","type-docs","status-publish","hentry"],"comment_count":0,"_links":{"self":[{"href":"https:\/\/help.cirrus-shield.com\/en\/wp-json\/wp\/v2\/docs\/1303","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/help.cirrus-shield.com\/en\/wp-json\/wp\/v2\/docs"}],"about":[{"href":"https:\/\/help.cirrus-shield.com\/en\/wp-json\/wp\/v2\/types\/docs"}],"author":[{"embeddable":true,"href":"https:\/\/help.cirrus-shield.com\/en\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/help.cirrus-shield.com\/en\/wp-json\/wp\/v2\/comments?post=1303"}],"version-history":[{"count":77,"href":"https:\/\/help.cirrus-shield.com\/en\/wp-json\/wp\/v2\/docs\/1303\/revisions"}],"predecessor-version":[{"id":8090,"href":"https:\/\/help.cirrus-shield.com\/en\/wp-json\/wp\/v2\/docs\/1303\/revisions\/8090"}],"up":[{"embeddable":true,"href":"https:\/\/help.cirrus-shield.com\/en\/wp-json\/wp\/v2\/docs\/1363"}],"next":[{"title":"Stripe","link":"https:\/\/help.cirrus-shield.com\/en\/docs\/admin-guide\/plugins\/stripe\/","href":"https:\/\/help.cirrus-shield.com\/en\/wp-json\/wp\/v2\/docs\/1397"}],"wp:attachment":[{"href":"https:\/\/help.cirrus-shield.com\/en\/wp-json\/wp\/v2\/media?parent=1303"}],"wp:term":[{"taxonomy":"doc_tag","embeddable":true,"href":"https:\/\/help.cirrus-shield.com\/en\/wp-json\/wp\/v2\/doc_tag?post=1303"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}