@botozap/sdk 0.17.0 → 0.18.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -1,5 +1,27 @@
1
1
  # @botozap/sdk
2
2
 
3
+ ## 0.18.0
4
+
5
+ ### Minor Changes
6
+
7
+ - 48db398: Link de setup com canal: cada link conecta um canal só, `whatsapp` (padrão) ou
8
+ `instagram`. No Instagram, o Cliente confirma que a conta é profissional e que as
9
+ mensagens estão liberadas e entra com o Instagram; `allowed_connection_types` não
10
+ vale (a API responde `422 invalid_connection_types`) e o link volta com
11
+ `allowed_connection_types: []` e `url` em `/instagram/setup/<token>`. Canal fora
12
+ desses dois responde `422 invalid_channel`. `whatsapp_setup_status` mantém o nome
13
+ e vale para os dois canais.
14
+
15
+ SDK: `channel?: "whatsapp" | "instagram"` em `CreateSetupLinkParams` e
16
+ `channel: "whatsapp" | "instagram"` em `SetupLink`. CLI: `setup-links create
17
+ --channel <whatsapp|instagram>` e coluna CANAL no `setup-links list`. MCP:
18
+ `create_setup_link` aceita `channel` opcional (padrão `whatsapp`) e o schema de
19
+ saída dos links de setup passa a trazer `channel`.
20
+
21
+ Requer a API com o campo `channel` nos links de setup (app BotoZap, branch
22
+ `feat/setup-link-instagram`): publique o MCP só depois desse deploy, porque o
23
+ schema de saída exige `channel`.
24
+
3
25
  ## 0.17.0
4
26
 
5
27
  ### Minor Changes
package/README.md CHANGED
@@ -473,7 +473,7 @@ new BotoZap({
473
473
  O SDK cobre os recursos da API `/v1`:
474
474
 
475
475
  - `messages` — enviar texto (com `quick_replies` no Instagram), template e mídia por link, **listar** e buscar por id
476
- - `customers` — listar, buscar, criar, **atualizar**, **remover**, e **links de setup** (listar/criar/atualizar)
476
+ - `customers` — listar, buscar, criar, **atualizar**, **remover**, e **links de setup** (listar/criar/atualizar; `channel` `whatsapp` ou `instagram`, um canal por link)
477
477
  - `templates` — listar, buscar, **criar**
478
478
  - `broadcasts` — criar, destinatários, agendar, enviar, cancelar
479
479
  - `contacts` — listar, buscar, criar, atualizar, remover; `display_name` é o nome que a empresa dá ao Contato (1–200 caracteres; `null` limpa), separado do `profile_name` que vem do canal
@@ -573,6 +573,20 @@ const link = await boto.customers.createSetupLink(customerId, {
573
573
  // Envie link.url ao Cliente. No sucesso, confirme o número em phoneNumbers.list:
574
574
  // uma conexão concluída ainda pode ter pendência de registro.
575
575
 
576
+ // Cada link conecta um canal só: channel "whatsapp" (padrão) ou "instagram"
577
+ // (outro valor → 422 invalid_channel). No Instagram, o Cliente confirma que a
578
+ // conta é profissional e que as mensagens estão liberadas e entra com o
579
+ // Instagram. allowed_connection_types não vale (enviar → 422
580
+ // invalid_connection_types); o link volta com allowed_connection_types: [] e
581
+ // url em /instagram/setup/<token>. whatsapp_setup_status vale para os dois
582
+ // canais e passa a completed quando a conta do Instagram conecta.
583
+ const linkIg = await boto.customers.createSetupLink(customerId, {
584
+ channel: "instagram",
585
+ success_redirect_url: "https://seu-app.com/instagram/ok", // status=completed
586
+ failure_redirect_url: "https://seu-app.com/instagram/erro", // status=cancelled
587
+ });
588
+ // linkIg.channel === "instagram"
589
+
576
590
  await boto.webhooks.create({
577
591
  url: "https://seu-app.com/hooks",
578
592
  events: ["messages", "statuses"], // categorias aceitas pela API (a rota rejeita nomes finos)
package/dist/index.cjs CHANGED
@@ -5351,7 +5351,8 @@ var Customers = class {
5351
5351
  * Cria um link de setup sob um cliente (expira em 30 dias). Envie a `url`
5352
5352
  * devolvida ao Cliente; veja em {@link CreateSetupLinkParams} como funcionam
5353
5353
  * os redirecionamentos. URL de redirecionamento inválida lança
5354
- * `BotoZapError` com `code: "invalid_redirect_url"` (422).
5354
+ * `BotoZapError` com `code: "invalid_redirect_url"` (422); canal inválido,
5355
+ * `code: "invalid_channel"` (422).
5355
5356
  */
5356
5357
  createSetupLink(customerId, params = {}) {
5357
5358
  return this.client.requestItem(