bzapper 0.8.1 → 0.8.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2492fe46b1c91f8b88b673e102de183388ec0aeba9686f83de3d62b50eb4cc01
-  data.tar.gz: 57c3253532c2a83d67cbbc21b811fc05f97a2c7ac331462fc7d4b60f4bb8a0c2
+  metadata.gz: c256b4bd21ae63812d103200cd409f3219afd1312e5bd1294a35c6bc917b437c
+  data.tar.gz: 2d90d51e0b528128c7d86096cb865116089c4fe4a88f7be2a5fa82f118994979
 SHA512:
-  metadata.gz: 60d10efd60798233d8c40d2f006da6d322d38af941a86d06cb148230ec6cf3a9df435a70a1db49f2630319781b76199e75fac7c2d736bdaf38a2e943279bd926
-  data.tar.gz: cfee6f2f48d55e3a40934cb509e85ac5832b42f76c1e677dd17d8f8f0f5384f0b617cc22ba25535c3375f7591ef8f959fc90a56cf3acd523696c170fab569287
+  metadata.gz: 4649dc966b6e70b094a9df4474312444d0e62b7b5b3c247ca23faa8d469b1a361768060e96aaeb00e45a9e062fc3164070e1bf5e2bd89fdddbea5d8ba3bd28e1
+  data.tar.gz: cbf1117963bde306d24d7044531758245712e71dabed736281ee20496476dda531aee8be965a98fa93402d645e11cf840a8b332a6abe4135040dd463efec77a5

data/README.md

@@ -10,13 +10,13 @@ Zero dependências de runtime (só biblioteca padrão: `net/http`, `json`, `open
 ## Instalação
 
 ```bash
-gem install bzapper -v 0.8.1
+gem install bzapper -v 0.8.2
 ```
 
 Ou no `Gemfile` — **fixe a versão exata** (cada release declara se muda a superfície pública):
 
 ```ruby
-gem "bzapper", "0.8.1"
+gem "bzapper", "0.8.2"
 ```
 
 ## Hello world
@@ -125,7 +125,7 @@ m.send_document(to: to, media: { url: "https://example.com/nota.pdf", filename:
 m.send_audio(to: to, media: { url: "https://example.com/audio.ogg", ptt: true }) # ptt = mensagem de voz
 m.send_sticker(to: to, media: { url: "https://example.com/sticker.webp" })
 m.send_location(to: to, latitude: -23.5613, longitude: -46.6565, name: "Av. Paulista")
-m.send_contact(to: to, contact_name: "Berni Software", contact_vcard: "BEGIN:VCARD…")
+m.send_contact(to: to, contact_name: "Berni Software", contact_phone: "+5511977776666")
 m.send_poll(to: to, name: "Pizza ou sushi?", options: %w[Pizza Sushi], selectable_count: 1)
 m.send_reaction(to: to, quoted_message_id: "ABCD1234", emoji: "👍") # emoji "" remove
 m.send_buttons(to: to, body: "Escolha:", buttons: [{ id: "a", title: "Opção A" }, { id: "b", title: "Opção B" }])

data/lib/bzapper/resources/messages.rb

@@ -17,7 +17,9 @@ module Bzapper
       #   instance_id/pool_id, it AUTOMATICALLY reuses the number that already talks to `to`, ensuring
       #   the whole interaction stays on the same number. Default **true**; send **false** to force
       #   rotation (e.g. campaign/broadcast).
-      # @param to [String] (corpo) Destination E.164 phone or JID.
+      # @param to [String] (corpo) Destination: E.164 phone (+DDIdigits), contact JID
+      #   (…@s.whatsapp.net), group JID (…@g.us) or the contact's @lid. A @lid is translated to the
+      #   phone when the connected number knows it; the official rail accepts phone only.
       # @param quoted_message_id [String, nil] (corpo) Quoted wa_message_id (reply).
       # @param quoted_participant [String, nil] (corpo) Author (phone or JID) of the quoted/reacted
       #   message. Only needed in groups when the quoted message is not in bZapper history — otherwise
@@ -80,7 +82,9 @@ module Bzapper
       #   instance_id/pool_id, it AUTOMATICALLY reuses the number that already talks to `to`, ensuring
       #   the whole interaction stays on the same number. Default **true**; send **false** to force
       #   rotation (e.g. campaign/broadcast).
-      # @param to [String] (corpo) Destination E.164 phone or JID.
+      # @param to [String] (corpo) Destination: E.164 phone (+DDIdigits), contact JID
+      #   (…@s.whatsapp.net), group JID (…@g.us) or the contact's @lid. A @lid is translated to the
+      #   phone when the connected number knows it; the official rail accepts phone only.
       # @param quoted_message_id [String, nil] (corpo) Quoted wa_message_id (reply).
       # @param quoted_participant [String, nil] (corpo) Author (phone or JID) of the quoted/reacted
       #   message. Only needed in groups when the quoted message is not in bZapper history — otherwise
@@ -143,7 +147,9 @@ module Bzapper
       #   instance_id/pool_id, it AUTOMATICALLY reuses the number that already talks to `to`, ensuring
       #   the whole interaction stays on the same number. Default **true**; send **false** to force
       #   rotation (e.g. campaign/broadcast).
-      # @param to [String] (corpo) Destination E.164 phone or JID.
+      # @param to [String] (corpo) Destination: E.164 phone (+DDIdigits), contact JID
+      #   (…@s.whatsapp.net), group JID (…@g.us) or the contact's @lid. A @lid is translated to the
+      #   phone when the connected number knows it; the official rail accepts phone only.
       # @param quoted_message_id [String, nil] (corpo) Quoted wa_message_id (reply).
       # @param quoted_participant [String, nil] (corpo) Author (phone or JID) of the quoted/reacted
       #   message. Only needed in groups when the quoted message is not in bZapper history — otherwise
@@ -206,7 +212,9 @@ module Bzapper
       #   instance_id/pool_id, it AUTOMATICALLY reuses the number that already talks to `to`, ensuring
       #   the whole interaction stays on the same number. Default **true**; send **false** to force
       #   rotation (e.g. campaign/broadcast).
-      # @param to [String] (corpo) Destination E.164 phone or JID.
+      # @param to [String] (corpo) Destination: E.164 phone (+DDIdigits), contact JID
+      #   (…@s.whatsapp.net), group JID (…@g.us) or the contact's @lid. A @lid is translated to the
+      #   phone when the connected number knows it; the official rail accepts phone only.
       # @param quoted_message_id [String, nil] (corpo) Quoted wa_message_id (reply).
       # @param quoted_participant [String, nil] (corpo) Author (phone or JID) of the quoted/reacted
       #   message. Only needed in groups when the quoted message is not in bZapper history — otherwise
@@ -270,7 +278,9 @@ module Bzapper
       #   instance_id/pool_id, it AUTOMATICALLY reuses the number that already talks to `to`, ensuring
       #   the whole interaction stays on the same number. Default **true**; send **false** to force
       #   rotation (e.g. campaign/broadcast).
-      # @param to [String] (corpo) Destination E.164 phone or JID.
+      # @param to [String] (corpo) Destination: E.164 phone (+DDIdigits), contact JID
+      #   (…@s.whatsapp.net), group JID (…@g.us) or the contact's @lid. A @lid is translated to the
+      #   phone when the connected number knows it; the official rail accepts phone only.
       # @param quoted_message_id [String, nil] (corpo) Quoted wa_message_id (reply).
       # @param quoted_participant [String, nil] (corpo) Author (phone or JID) of the quoted/reacted
       #   message. Only needed in groups when the quoted message is not in bZapper history — otherwise
@@ -333,7 +343,9 @@ module Bzapper
       #   instance_id/pool_id, it AUTOMATICALLY reuses the number that already talks to `to`, ensuring
       #   the whole interaction stays on the same number. Default **true**; send **false** to force
       #   rotation (e.g. campaign/broadcast).
-      # @param to [String] (corpo) Destination E.164 phone or JID.
+      # @param to [String] (corpo) Destination: E.164 phone (+DDIdigits), contact JID
+      #   (…@s.whatsapp.net), group JID (…@g.us) or the contact's @lid. A @lid is translated to the
+      #   phone when the connected number knows it; the official rail accepts phone only.
       # @param quoted_message_id [String, nil] (corpo) Quoted wa_message_id (reply).
       # @param quoted_participant [String, nil] (corpo) Author (phone or JID) of the quoted/reacted
       #   message. Only needed in groups when the quoted message is not in bZapper history — otherwise
@@ -397,7 +409,9 @@ module Bzapper
       #   instance_id/pool_id, it AUTOMATICALLY reuses the number that already talks to `to`, ensuring
       #   the whole interaction stays on the same number. Default **true**; send **false** to force
       #   rotation (e.g. campaign/broadcast).
-      # @param to [String] (corpo) Destination E.164 phone or JID.
+      # @param to [String] (corpo) Destination: E.164 phone (+DDIdigits), contact JID
+      #   (…@s.whatsapp.net), group JID (…@g.us) or the contact's @lid. A @lid is translated to the
+      #   phone when the connected number knows it; the official rail accepts phone only.
       # @param quoted_message_id [String, nil] (corpo) Quoted wa_message_id (reply).
       # @param quoted_participant [String, nil] (corpo) Author (phone or JID) of the quoted/reacted
       #   message. Only needed in groups when the quoted message is not in bZapper history — otherwise
@@ -467,7 +481,9 @@ module Bzapper
       #   instance_id/pool_id, it AUTOMATICALLY reuses the number that already talks to `to`, ensuring
       #   the whole interaction stays on the same number. Default **true**; send **false** to force
       #   rotation (e.g. campaign/broadcast).
-      # @param to [String] (corpo) Destination E.164 phone or JID.
+      # @param to [String] (corpo) Destination: E.164 phone (+DDIdigits), contact JID
+      #   (…@s.whatsapp.net), group JID (…@g.us) or the contact's @lid. A @lid is translated to the
+      #   phone when the connected number knows it; the official rail accepts phone only.
       # @param quoted_message_id [String, nil] (corpo) Quoted wa_message_id (reply).
       # @param quoted_participant [String, nil] (corpo) Author (phone or JID) of the quoted/reacted
       #   message. Only needed in groups when the quoted message is not in bZapper history — otherwise
@@ -488,8 +504,12 @@ module Bzapper
       # @param force [Boolean, nil] (corpo) OPTIONAL. When true, bypasses an inferred suppression
       #   (e.g. opt-out inferred from behaviour) for this send. Does NOT override an explicit
       #   suppression entry (`/suppressions`) — use with care and only with a lawful basis.
-      # @param contact_name [String, nil] (corpo)
-      # @param contact_vcard [String, nil] (corpo)
+      # @param contact_name [String, nil] (corpo) Name shown on the card.
+      # @param contact_phone [String, nil] (corpo) The CARD CONTACT's phone in E.164 — the person
+      #   being shared, never the destination. Required with contact_name (not needed when you send a
+      #   ready contact_vcard); it is what makes WhatsApp recognise the card as a contact.
+      # @param contact_vcard [String, nil] (corpo) Ready vCard; when present,
+      #   contact_name/contact_phone are not used to build one.
       # @param idempotency_key [String, nil] chave de idempotência (senão a SDK gera uma).
       # @param timeout [Numeric, nil] segundos por tentativa (padrão: o do cliente).
       # @return [Hash, Array, nil] o JSON da resposta, inteiro (nil em 204).
@@ -498,7 +518,8 @@ module Bzapper
                        quoted_message_id: UNSET, quoted_participant: UNSET,
                        client_reference: UNSET, mentions: UNSET, scheduled_at: UNSET,
                        groups: UNSET, tags: UNSET, force: UNSET, contact_name: UNSET,
-                       contact_vcard: UNSET, idempotency_key: nil, timeout: nil)
+                       contact_phone: UNSET, contact_vcard: UNSET, idempotency_key: nil,
+                       timeout: nil)
         payload = compact(
           "instance_id" => instance_id,
           "pool_id" => pool_id,
@@ -513,6 +534,7 @@ module Bzapper
           "tags" => tags,
           "force" => force,
           "contact_name" => contact_name,
+          "contact_phone" => contact_phone,
           "contact_vcard" => contact_vcard
         )
         request("POST",
@@ -533,7 +555,9 @@ module Bzapper
       #   instance_id/pool_id, it AUTOMATICALLY reuses the number that already talks to `to`, ensuring
       #   the whole interaction stays on the same number. Default **true**; send **false** to force
       #   rotation (e.g. campaign/broadcast).
-      # @param to [String] (corpo) Destination E.164 phone or JID.
+      # @param to [String] (corpo) Destination: E.164 phone (+DDIdigits), contact JID
+      #   (…@s.whatsapp.net), group JID (…@g.us) or the contact's @lid. A @lid is translated to the
+      #   phone when the connected number knows it; the official rail accepts phone only.
       # @param quoted_message_id [String, nil] (corpo) Quoted wa_message_id (reply).
       # @param quoted_participant [String, nil] (corpo) Author (phone or JID) of the quoted/reacted
       #   message. Only needed in groups when the quoted message is not in bZapper history — otherwise
@@ -600,7 +624,9 @@ module Bzapper
       #   instance_id/pool_id, it AUTOMATICALLY reuses the number that already talks to `to`, ensuring
       #   the whole interaction stays on the same number. Default **true**; send **false** to force
       #   rotation (e.g. campaign/broadcast).
-      # @param to [String] (corpo) Destination E.164 phone or JID.
+      # @param to [String] (corpo) Destination: E.164 phone (+DDIdigits), contact JID
+      #   (…@s.whatsapp.net), group JID (…@g.us) or the contact's @lid. A @lid is translated to the
+      #   phone when the connected number knows it; the official rail accepts phone only.
       # @param quoted_message_id [String] (corpo) Quoted wa_message_id (reply).
       # @param quoted_participant [String, nil] (corpo) Author (phone or JID) of the quoted/reacted
       #   message. Only needed in groups when the quoted message is not in bZapper history — otherwise
@@ -666,7 +692,9 @@ module Bzapper
       #   instance_id/pool_id, it AUTOMATICALLY reuses the number that already talks to `to`, ensuring
       #   the whole interaction stays on the same number. Default **true**; send **false** to force
       #   rotation (e.g. campaign/broadcast).
-      # @param to [String] (corpo) Destination E.164 phone or JID.
+      # @param to [String] (corpo) Destination: E.164 phone (+DDIdigits), contact JID
+      #   (…@s.whatsapp.net), group JID (…@g.us) or the contact's @lid. A @lid is translated to the
+      #   phone when the connected number knows it; the official rail accepts phone only.
       # @param quoted_message_id [String, nil] (corpo) Quoted wa_message_id (reply).
       # @param quoted_participant [String, nil] (corpo) Author (phone or JID) of the quoted/reacted
       #   message. Only needed in groups when the quoted message is not in bZapper history — otherwise
@@ -734,7 +762,9 @@ module Bzapper
       #   instance_id/pool_id, it AUTOMATICALLY reuses the number that already talks to `to`, ensuring
       #   the whole interaction stays on the same number. Default **true**; send **false** to force
       #   rotation (e.g. campaign/broadcast).
-      # @param to [String] (corpo) Destination E.164 phone or JID.
+      # @param to [String] (corpo) Destination: E.164 phone (+DDIdigits), contact JID
+      #   (…@s.whatsapp.net), group JID (…@g.us) or the contact's @lid. A @lid is translated to the
+      #   phone when the connected number knows it; the official rail accepts phone only.
       # @param quoted_message_id [String, nil] (corpo) Quoted wa_message_id (reply).
       # @param quoted_participant [String, nil] (corpo) Author (phone or JID) of the quoted/reacted
       #   message. Only needed in groups when the quoted message is not in bZapper history — otherwise
@@ -808,7 +838,9 @@ module Bzapper
       #   instance_id/pool_id, it AUTOMATICALLY reuses the number that already talks to `to`, ensuring
       #   the whole interaction stays on the same number. Default **true**; send **false** to force
       #   rotation (e.g. campaign/broadcast).
-      # @param to [String] (corpo) Destination E.164 phone or JID.
+      # @param to [String] (corpo) Destination: E.164 phone (+DDIdigits), contact JID
+      #   (…@s.whatsapp.net), group JID (…@g.us) or the contact's @lid. A @lid is translated to the
+      #   phone when the connected number knows it; the official rail accepts phone only.
       # @param quoted_message_id [String, nil] (corpo) Quoted wa_message_id (reply).
       # @param quoted_participant [String, nil] (corpo) Author (phone or JID) of the quoted/reacted
       #   message. Only needed in groups when the quoted message is not in bZapper history — otherwise

data/lib/bzapper/version.rb

@@ -3,5 +3,5 @@
 module Bzapper
   # Versão da gem. O `scripts/release-sdks.sh` do monorepo bumpa a linha abaixo por regex
   # (ancorada no início da linha) e o `bzapper.gemspec` lê daqui — não mude o formato dela.
-  VERSION = "0.8.1"
+  VERSION = "0.8.2"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: bzapper
 version: !ruby/object:Gem::Version
-  version: 0.8.1
+  version: 0.8.2
 platform: ruby
 authors:
 - Berni Software