@botozap/sdk 0.14.0 → 0.15.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 +12 -0
- package/README.md +20 -1
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +44 -1
- package/dist/index.d.ts +44 -1
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,17 @@
|
|
|
1
1
|
# @botozap/sdk
|
|
2
2
|
|
|
3
|
+
## 0.15.0
|
|
4
|
+
|
|
5
|
+
### Minor Changes
|
|
6
|
+
|
|
7
|
+
- 45169ad: Webhooks por canal: `channel_account_ids` em create/update (ausente = todos no
|
|
8
|
+
create e sem mudança no update; `null` volta a todos) e, na leitura,
|
|
9
|
+
`channel_account_ids` e `channels_health` (saúde por canal, só dos canais em
|
|
10
|
+
falha). CLI ganha `--channel-account-id` (repetível) e `--all-channels`, e mostra
|
|
11
|
+
canais e saúde por canal em `webhooks get/list`. MCP aceita `channel_account_ids`
|
|
12
|
+
em `create_webhook`/`update_webhook` e devolve os campos novos na saída
|
|
13
|
+
estruturada.
|
|
14
|
+
|
|
3
15
|
## 0.14.0
|
|
4
16
|
|
|
5
17
|
### Minor Changes
|
package/README.md
CHANGED
|
@@ -394,6 +394,25 @@ e `app_messages`, opt-in, com `whatsapp.message.echo`, `.edited` e `.revoked` do
|
|
|
394
394
|
app WhatsApp Business em coexistência. Em `webhookDeliveries.list`, o status
|
|
395
395
|
`limited` marca a entrega cortada pelo limite de repasse do Free (sem retry).
|
|
396
396
|
|
|
397
|
+
`channel_account_ids` limita um Endpoint a alguns canais (ids de
|
|
398
|
+
`channelAccounts.list`, os mesmos de `channel_account.id` nos payloads; 1 a
|
|
399
|
+
100). No create, omitido ou `null` = todos os canais. No update, omitido não
|
|
400
|
+
muda, `null` volta a todos e um array substitui a lista. A leitura devolve
|
|
401
|
+
`channel_account_ids` (`null` = todos; vazio quando os canais marcados foram
|
|
402
|
+
excluídos, e o Endpoint então não recebe eventos) e `channels_health`, só com
|
|
403
|
+
os canais em falha (`channel_account_id: null` = eventos sem canal). A espera,
|
|
404
|
+
as falhas seguidas e a pausa (na 15ª falha) contam por canal: um canal pausado
|
|
405
|
+
não para os outros. `health_status` e `failure_streak` do Endpoint resumem o
|
|
406
|
+
pior canal; `paused` só aparece quando todos os canais com falha estão
|
|
407
|
+
pausados. Erros: `422 invalid_channel_account_ids` e
|
|
408
|
+
`404 channel_account_not_found`.
|
|
409
|
+
|
|
410
|
+
```ts
|
|
411
|
+
await boto.webhooks.update(endpointId, { channel_account_ids: [canalId] });
|
|
412
|
+
await boto.webhooks.update(endpointId, { channel_account_ids: null }); // todos
|
|
413
|
+
const { channels_health } = await boto.webhooks.get(endpointId);
|
|
414
|
+
```
|
|
415
|
+
|
|
397
416
|
## Configuração
|
|
398
417
|
|
|
399
418
|
```ts
|
|
@@ -418,7 +437,7 @@ O SDK cobre os recursos da API `/v1`:
|
|
|
418
437
|
- `broadcasts` — criar, destinatários, agendar, enviar, cancelar
|
|
419
438
|
- `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
|
|
420
439
|
- `conversations` — listar (filtros `channel` e `channel_account_id`), buscar, atualizar, responder, atribuições; leituras trazem `entry_point` (`ctwa`/`organic`/`null`), `referral` do último clique em anúncio Click-to-WhatsApp, `fep_expires_at` (fim da janela grátis informado pela Meta) e `fep_reply_by` (estimativa do prazo para responder)
|
|
421
|
-
- `webhooks` — CRUD e teste; `customer_id` opcional limita as entregas a um Cliente da Conta (`null` no update remove o filtro)
|
|
440
|
+
- `webhooks` — CRUD e teste; `customer_id` opcional limita as entregas a um Cliente da Conta (`null` no update remove o filtro); `channel_account_ids` limita a alguns canais (`null` = todos) e `channels_health` traz a saúde por canal
|
|
422
441
|
- `channelAccounts` — listar e buscar Contas de canal (WhatsApp e Instagram); **Regras de comentário** do Instagram (listar, buscar, criar, atualizar, excluir) e **Perguntas e menu** (ler, salvar/aplicar, remover, verificar/reaplicar)
|
|
423
442
|
- `phoneNumbers` — listar, buscar, **atualizar o `label`** (nome local, até 100 caracteres; `null` limpa), remover, saúde
|
|
424
443
|
- `media` — subir arquivo (obter um media_id) e **buscar metadados + URL de download** de uma mídia recebida
|