@botozap/sdk 0.20.0 → 0.21.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,21 @@
1
1
  # @botozap/sdk
2
2
 
3
+ ## 0.21.0
4
+
5
+ ### Minor Changes
6
+
7
+ - 03f25cd: Entregas de webhook por canal: `webhookDeliveries.list` aceita
8
+ `channel_account_id` (o uuid do canal, ou `none` para as entregas sem canal,
9
+ como o teste), e cada entrega traz `channel_account_id`. CLI:
10
+ `deliveries list --channel-account-id <id>` e a coluna HTTP volta a mostrar o
11
+ código da resposta. MCP: `list_webhook_deliveries` aceita `channel_account_id`.
12
+
13
+ ## 0.20.1
14
+
15
+ ### Patch Changes
16
+
17
+ - bef36f5: CLI: `--idempotency-key` em `messages send` (inclusive `--input`/`--stdin`), `send-media`, `send-interactive`, `send-location` e `react`, enviado no header `Idempotency-Key`. SDK: o README orienta derivar a chave do evento e lista todos os métodos de envio que aceitam `idempotencyKey`.
18
+
3
19
  ## 0.20.0
4
20
 
5
21
  ### Minor Changes
package/README.md CHANGED
@@ -781,18 +781,23 @@ Informe uma única credencial. O SDK envia `Authorization: Bearer` e não realiz
781
781
 
782
782
  ### Repetir um envio sem duplicar a intenção
783
783
 
784
- A opção `idempotencyKey` é opcional. Crie uma chave antes da primeira tentativa
785
- e preserve-a se perder a resposta; o corpo e a credencial também devem ser os
784
+ A opção `idempotencyKey` é opcional. Derive a chave do evento no seu sistema
785
+ (o pedido, a assinatura, a data do aviso), para que qualquer processo que tente
786
+ o mesmo envio use a mesma chave; o corpo e a credencial também devem ser os
786
787
  mesmos. Sem a opção, o SDK mantém o comportamento anterior.
787
788
 
788
789
  ```ts
789
- const options = { idempotencyKey: crypto.randomUUID() };
790
+ const options = { idempotencyKey: `pedido-pronto-${pedido.id}` };
790
791
  await boto.messages.send({ to: "5511999999999", text: "Seu pedido está pronto." }, options);
791
792
  // Retry da mesma intenção: use novamente o mesmo payload e options.
792
793
  ```
793
794
 
794
- `sendTemplate`, `sendMedia` e `conversations.reply` aceitam a mesma opção como
795
- último argumento. O servidor retorna a resposta original; payload diferente ou
795
+ Uma chave aleatória (`crypto.randomUUID()`) só protege se for criada e
796
+ guardada antes da primeira tentativa: dois processos que geram cada um a sua
797
+ não se enxergam, e as duas mensagens saem.
798
+
799
+ `sendTemplate`, `sendMedia`, `sendInteractive`, `sendLocation`, `sendReaction` e
800
+ `conversations.reply` aceitam a mesma opção como último argumento. O servidor retorna a resposta original; payload diferente ou
796
801
  tentativa pendente retornam 409. Resultados terminais ficam disponíveis por 24h.
797
802
  Pendências desconhecidas não reabrem automaticamente. Depois de 24h, confira o
798
803
  histórico antes de reenviar; nunca troque a chave para contornar uma pendência.
package/dist/index.cjs CHANGED
@@ -6298,7 +6298,8 @@ var WebhookDeliveries = class {
6298
6298
  before: params.before,
6299
6299
  webhook_id: params.webhook_id,
6300
6300
  status: params.status,
6301
- event_type: params.event_type
6301
+ event_type: params.event_type,
6302
+ channel_account_id: params.channel_account_id
6302
6303
  }
6303
6304
  }
6304
6305
  );