@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 +16 -0
- package/README.md +10 -5
- package/dist/index.cjs +2 -1
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +2 -0
- package/dist/index.d.ts +2 -0
- 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,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.
|
|
785
|
-
|
|
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:
|
|
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
|
-
|
|
795
|
-
|
|
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
|
);
|