sfmc_emailer 0.0.3 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 71670b98e465d6aeb3b6a6816634bde6ee9d9da9a712d559daf0bea7b1bb64d2
-  data.tar.gz: 5e59ee0b279dbd6a0523d3ddd2dbab5c7b894a7f1888940dbcc478502a47054d
+  metadata.gz: 784c3443d92f1e20640d6df8652b028099b7e88c7db36dfc35655cfb7efd158e
+  data.tar.gz: bc658a904d420d4183a8b06725bf4ea3ff3ef04650fb323c3d15d428191a79a7
 SHA512:
-  metadata.gz: a362ec1e2c90134f035b02bde553757ca8bf0bce374e29667888133422950a7660a474fd6b7683f426482154601dc05df53607171485d184cbaf917a6fc3b1c5
-  data.tar.gz: 1232d21dad0c1ba5e10b86cb7e078b96475ecede5eb3bb1221bc00c6ec8d47b173519839871190c7a70fee221985d133e62c4cda98650828d61615b322e76f7c
+  metadata.gz: 0ab0333fea8c05c3951b6c37ec09b51cccb2e252d209b42207cd4461da1bdc659d8d7e2c21eb922a55305ddcd43198b52042670722eab6e9bd5d45d55732c20b
+  data.tar.gz: 07b1be656a13c724cc1793975b622eac445a2676a803a497a4cccb879e5d44abae993a82d8960d4ce8fdb6bf1b6768cdb74e3c4e1cdd4c3a836c346c9699a292

data/README.md

@@ -0,0 +1,60 @@
+# Salesforce Marketing Cloud (SFMC) Emailer
+Supports sending both transactional & triggered send (marketing) emails
+
+## How to use
+### Config
+```ruby
+# config/initializers/sfmc.rb
+
+SFMC::SFMCBase.init(
+  subdomain: 'mchf5m7e9wjxn-f2xxn6l5ul1x0q',
+  client_id: 'client_id',
+  client_secret: 'super_secret',
+  default_send_classification: 'Default Send Classification - 293',
+  default_subscriber_list: 'All Subscribers - 9136',
+  default_data_extension: 'C4530F44-5C72-4113-8EA0-5210C9222455',
+  default_bcc: ['example@example.com'] # optional
+)
+```
+
+### Transactional Emails
+
+```ruby
+SFMC::Transactional::Email.send_email(
+  email: 'email_name',
+  to: 'example@example.com',
+  params: { # Each attribute should be present in the corresponding data extension in SFMC
+    First_Name: "Bob",
+  }
+)
+```
+
+### Triggered Send Emails
+
+```ruby
+SFMC::Triggered::Email.send_email(
+  email: 'email_name',
+  to: 'example@example.com',
+  params: { # Each attribute should be present in the corresponding data extension in SFMC
+    First_Name: "Bob",
+  }
+)
+```
+
+<b>Note:</b> Changes to transactional emails only take effect once its send definition is refreshed:
+```ruby
+SFMC::Transactional::SendDefinition.refresh 'email_name'
+```
+
+### Creating a Transactional Email Send Definition
+<b>Note:</b> The first time an email is sent a send definition for it will be created with the default values. This definition takes about a minute to actually become active, so try sending again after that. You can also manually create a send definition using:
+```ruby
+SFMC::Transactional::SendDefinition.create(
+  definition_key: 'definition_key', 
+  customer_key: 'customer_key', 
+  send_classification: 'send_classification', 
+  subscriber_list: 'subscriber_list', 
+  data_extension: 'data_extension', 
+  bcc: ['example@example.com'] # optional
+)
+```

data/lib/sfmc/errors.rb

@@ -1,13 +1,11 @@
 module SFMC
   module Errors
-    # rubocop:disable Layout/EmptyLineBetweenDefs
     class BadRequestError < StandardError; end
     class UnauthorizedError < StandardError; end
     class ForbiddenError < StandardError; end
     class NotFoundError < StandardError; end
     class UnprocessableEntityError < StandardError; end
     class APIError < StandardError; end
-    # rubocop:enable Layout/EmptyLineBetweenDefs
 
     def error_class(code)
       case code.to_i

data/lib/sfmc/transactional/email.rb

@@ -6,16 +6,16 @@ module SFMC
       # If an email hasn't ever been sent then we will not have an email send definition
       # We're waiting a minute for the send definition to fully be initialized
       # Thankfully this is a rare edge case
-      def self.create_email_send_definition_and_retry(name, to, params)
+      def self.create_email_send_definition(name)
         asset = SFMC::Assets::Asset.query("name eq '#{name}'", 'customerKey')
         raise SFMC::Errors::BadRequestError, "No emails found with name #{name}" if asset.count == 0
 
         consumer_key = asset.items.first["customerKey"]
 
-        SFMC::Transactional::SendDefinition.create(name, consumer_key)
+        SFMC::Transactional::SendDefinition.create(definition_key: name, customer_key: consumer_key)
 
         # Even though the send def is "Active" it won't function for another minute
-        delay(run_at: 70.seconds.from_now).send_email(email: name, to: to, params: params, create_email_if_needed: false)
+        pp "Email send definition inactive. Try again in a minute"
       end
 
       # Will attempt once to create a new email send definition if one isn't found
@@ -43,7 +43,7 @@ module SFMC
         rescue SFMC::Errors::NotFoundError
           raise unless create_email_if_needed
 
-          create_email_send_definition_and_retry(email, to, params)
+          create_email_send_definition(email)
         end
       end
     end

data/lib/sfmc/transactional/send_definition.rb

@@ -9,12 +9,12 @@ module SFMC
       end
 
       def self.create(
-        definition_key,
-        customer_key,
-        send_classification = nil,
-        subscriber_list = nil,
-        data_extension = nil,
-        bcc = []
+        definition_key:,
+        customer_key:,
+        send_classification: nil,
+        subscriber_list: nil,
+        data_extension: nil,
+        bcc: []
       )
         params = {
           classification: SFMCBase.default_send_classification || send_classification,

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sfmc_emailer
 version: !ruby/object:Gem::Version
-  version: 0.0.3
+  version: 1.0.1
 platform: ruby
 authors:
 - Angel Ruiz-Bates
@@ -17,6 +17,9 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.20'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.20'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -24,6 +27,49 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '0.20'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.20'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.18.1
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.18.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.18.1
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.18.1
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.11.0
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.11.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 3.11.0
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.11.0
 description: API wrapper for Salesforce Marketing Cloud's Transactional and Triggered
   Send APIs
 email: angeljrbt@gmail.com
@@ -31,6 +77,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- README.md
 - lib/sfmc/assets/asset.rb
 - lib/sfmc/authentication.rb
 - lib/sfmc/contacts/contact_key.rb
@@ -41,7 +88,7 @@ files:
 - lib/sfmc/transactional/send_definition.rb
 - lib/sfmc/triggered/email.rb
 - lib/sfmc_emailer.rb
-homepage: https://rubygems.org/gems/sfmc_emailer
+homepage: https://github.com/angeljruiz/SFMC-Email-Client
 licenses:
 - MIT
 metadata: {}
@@ -60,7 +107,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.6
+rubygems_version: 3.1.4
 signing_key:
 specification_version: 4
 summary: API wrapper for SFMC