vatio-sdk 0.8.0 → 0.9.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8c921c47af7fe3fc6252679275a7717a2c3df5651c2772af28bb99202a8d11bb
-  data.tar.gz: 243719a522e1007183c248e847067f975ac727063edba7d561b85c941aecc596
+  metadata.gz: 8fc024c85ca67669f7b0971a9fafbd65c0932f1608e7e2ffdc8a8714088d5e5c
+  data.tar.gz: 4801d1b1efe265284e53ae3c2d29ae09cda61016e85c66c33547f1fe2723ae81
 SHA512:
-  metadata.gz: 733e344de538c7430bbb5c85f51152aa87949a0fa70e0ac0bc01dd2fdffc29bb620887105c3e00e2c604b75506e44bc4bc606e361e7713f095bf5aee1f6393e5
-  data.tar.gz: 344d942247e4a56f60fd2a601a917eb4305668d628d40ac8c658b02f092d234c179ad6506b61d40cb4a8cb924b44603fe729f912391c7ce5e4a3553c8c315791
+  metadata.gz: 5105ee83825f513850f5e0196af8c6af66dd9aa5a500e0cc9f1be60f47a1be04fd055532e432f5ee394144790d3f1186ac427686e10a5778f6605fac32d6eff8
+  data.tar.gz: 600c732a95c860429fab141eb4ae4a70cd945a477c1a20f1c63609a6916c7bc99334c0fed9fc8a7d679dd70b80af6e16064dd6259db816355f866646e3ee172c

data/README.md

@@ -242,6 +242,17 @@ you:
   template: offer.with_params("Ana").merge(buttons: [{ index: 0, params: [offer.code] }])
   ```
 
+  Anything else a template takes (a media or text header, named
+  parameters, a coupon code) goes as Meta's own send components, as each
+  template's `example` shows:
+
+  ```ruby
+  template: { name: "ati_offer", language: "es", components: [
+    { type: "header", parameters: [{ type: "image", image: { link: photo_url } }] },
+    { type: "body", parameters: [{ type: "text", parameter_name: "name", text: "Ana" }] }
+  ] }
+  ```
+
 The response only says it is queued: the agent's turn and Meta's delivery
 both happen after it. `Vatio::Server.message_status(id)` reads it back,
 with `content` (what reached the phone) once it is sent, and
@@ -301,7 +312,7 @@ end
 | `OutsideWindow` | `outside_window`, with `last_inbound_at` |
 | `OptedOut` | `opted_out` |
 | `HumanAnswering` | `human_takeover`, `handoff_pending` |
-| `TemplateError` | `template_not_found` (often created in Meta a minute ago: Vatio is syncing, retry shortly), `template_not_approved`, `template_params`, `template_buttons`, `template_required` |
+| `TemplateError` | `template_not_found` (often created in Meta a minute ago: Vatio is syncing, retry shortly), `template_not_approved`, `template_params`, `template_buttons`, `template_components`, `template_required` |
 | `InvalidRequest` | Any other 422: `invalid_recipient`, `content_required`, `invalid_identity`, `not_a_test_phone`… |
 | `Unauthorized` | 401 / 403: the key is wrong, revoked, or another workspace's |
 | `Conflict` | Any other 409: `idempotency_conflict` (`details["message_id"]`), `identity_conflict`, `whatsapp_not_connected`, `whatsapp_paused`, `whatsapp_number_unhealthy` (Meta refuses every send from the number; `details["issue"]` says why and the fix) |

data/lib/vatio/identity/version.rb

@@ -2,6 +2,6 @@
 
 module Vatio
   module Identity
-    VERSION = "0.8.0"
+    VERSION = "0.9.0"
   end
 end

data/lib/vatio/server/client.rb

@@ -38,7 +38,9 @@ module Vatio
       # template: { name:, language:, params: [], buttons: [{ index:, params: [] }] },
       #           used only when the 24-hour window is closed -- send it too
       #           to always reach the person. `buttons` fills URL buttons
-      #           whose link ends in {{1}}.
+      #           whose link ends in {{1}}. Or { name:, language:, components: [] }
+      #           with Meta's own send components, for anything else a
+      #           template takes (a header, named parameters, a coupon code).
       #           An authentication template takes `code:` instead of params,
       #           with no brief or text, and is sent whatever the window.
       #
@@ -150,6 +152,10 @@ module Vatio
       # Accepts a Hash with symbol or string keys, or anything with `to_h`.
       def normalize_template(template)
         hash = template.to_h.transform_keys(&:to_s)
+        if hash.key?("components")
+          return { name: hash["name"], language: hash["language"], components: Array(hash["components"]) }
+        end
+
         { name: hash["name"], language: hash["language"], params: Array(hash["params"]).map(&:to_s),
           code: hash["code"]&.to_s, buttons: normalize_buttons(hash["buttons"]) }.compact
       end

data/lib/vatio/server/template.rb

@@ -13,9 +13,15 @@ module Vatio
     #
     #   template: offer.with_params("Ana").merge(buttons: [{ index: 0, params: ["ABC123"] }])
     #
+    # Anything else it takes (a header, named parameters, a coupon code) goes
+    # as Meta's own send components; `example` shows them:
+    #
+    #   template: { name: t.name, language: t.language, components: [...] }
+    #
     # Empty on a preview key: the preview number's templates are Vatio's.
     Template = Struct.new(
-      :name, :language, :category, :status, :rejected_reason, :body, :parameter_count, :buttons, :example,
+      :name, :language, :category, :status, :rejected_reason, :body, :parameter_count, :parameter_format, :buttons,
+      :components, :example,
       keyword_init: true
     ) do
       def self.from(hash) = Value.build(self, hash)

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: vatio-sdk
 version: !ruby/object:Gem::Version
-  version: 0.8.0
+  version: 0.9.0
 platform: ruby
 authors:
 - Urcalab