@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 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