@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 +22 -0
- package/README.md +15 -1
- package/dist/index.cjs +2 -1
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +28 -5
- package/dist/index.d.ts +28 -5
- package/dist/index.js +2 -1
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
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(
|