@botozap/sdk 0.26.0 → 0.29.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,23 @@
1
1
  # @botozap/sdk
2
2
 
3
+ ## 0.29.0
4
+
5
+ ### Minor Changes
6
+
7
+ - 750d80e: Editar e excluir template fora do painel: `templates.update(id, { components, category })` edita e reenvia à análise da Meta, e `templates.delete(id)` exclui na Meta e aqui (SDK); `update_template` ganha `components`/`category` e entra `delete_template` (MCP); `botozap templates update --components` e `botozap templates delete` (CLI).
8
+
9
+ ## 0.28.0
10
+
11
+ ### Minor Changes
12
+
13
+ - d33253b: Sincronizar templates com a Meta fora do painel: `templates.sync()` (SDK), a tool `sync_templates` (MCP) e `botozap templates sync` (CLI) chamam `POST /v1/templates/sync`, que traz o status real, importa os criados no WhatsApp Manager e tira os excluídos lá. `customer_id` limita a um Cliente.
14
+
15
+ ## 0.27.0
16
+
17
+ ### Minor Changes
18
+
19
+ - 4b22f9b: Mensagens que pararam de chegar com a autorização valendo: `phoneNumbers.resubscribeWebhooks(id)` (SDK), a tool `resubscribe_phone_number_webhooks` (MCP) e `botozap numbers resubscribe-webhooks <id>` (CLI) chamam `POST /v1/phone_numbers/{id}/webhook-subscription` e inscrevem o BotoZap de novo na Meta, sem refazer a conexão. A saúde do número (`phone_number_health`) passa a explicar `checks.webhook_subscription`.
20
+
3
21
  ## 0.26.0
4
22
 
5
23
  ### Minor Changes
package/dist/index.cjs CHANGED
@@ -5507,10 +5507,11 @@ var Templates = class {
5507
5507
  });
5508
5508
  }
5509
5509
  /**
5510
- * Marca quais botões de resposta rápida são de saída (`opt_out_buttons`). O toque
5511
- * num botão marcado grava a recusa da finalidade do template; botão não marcado
5512
- * não muda nada, qualquer que seja o texto. Não altera o template na Meta.
5513
- * Scope `templates:write`.
5510
+ * Com `components` (e `category`), edita o template e o devolve à análise da
5511
+ * Meta, como o Editar do painel: em análise responde 409 `template_in_review`;
5512
+ * sem id da Meta, 409 `template_not_synced`. Só com `opt_out_buttons`, marca
5513
+ * quais botões de resposta rápida são de saída, sem alterar o template na
5514
+ * Meta. Scope `templates:write`.
5514
5515
  */
5515
5516
  update(id, params) {
5516
5517
  return this.client.requestItem(
@@ -5519,6 +5520,24 @@ var Templates = class {
5519
5520
  { body: params }
5520
5521
  );
5521
5522
  }
5523
+ /**
5524
+ * O Sincronizar da tela de Templates: traz da Meta status, categoria,
5525
+ * conteúdo e `rejection_reason` dos templates das conexões ativas (ou de um
5526
+ * Cliente), importa os criados no WhatsApp Manager e tira daqui os excluídos
5527
+ * lá. Use quando um status parecer parado. Autorização recusada pela Meta
5528
+ * responde 409 `reconnect_required`. Scope `templates:write`.
5529
+ */
5530
+ sync(params = {}) {
5531
+ return this.client.requestItem("POST", "/templates/sync", { body: params });
5532
+ }
5533
+ /**
5534
+ * Exclui o template na Meta e aqui, como o Excluir do painel. Com o id da Meta
5535
+ * apaga só aquela versão de idioma; sem ele, a Meta apaga todas as do mesmo
5536
+ * nome. Não dá para desfazer. Só chave de produção. Scope `templates:write`.
5537
+ */
5538
+ delete(id) {
5539
+ return this.client.requestItem("DELETE", `/templates/${encodeURIComponent(id)}`);
5540
+ }
5522
5541
  };
5523
5542
 
5524
5543
  // src/resources/broadcasts.ts
@@ -6155,13 +6174,26 @@ var PhoneNumbers = class {
6155
6174
  body: { window_days: params.window_days }
6156
6175
  });
6157
6176
  }
6158
- /** Saúde do número (qualidade, limite, status na Meta). */
6177
+ /**
6178
+ * Prontidão do número. Com a conexão ativa, confere ao vivo o token
6179
+ * (`checks.token_validity`) e se a Meta manda as mensagens para o BotoZap
6180
+ * (`checks.webhook_subscription`).
6181
+ */
6159
6182
  health(id) {
6160
6183
  return this.client.requestItem(
6161
6184
  "GET",
6162
6185
  `/phone_numbers/${enc6(id)}/health`
6163
6186
  );
6164
6187
  }
6188
+ /**
6189
+ * Inscreve o BotoZap de novo para receber as mensagens do número, com a
6190
+ * autorização já guardada, sem refazer a conexão. Resolve a prontidão
6191
+ * `webhooks_lost`; autorização recusada pela Meta responde 409
6192
+ * `reconnect_required` (aí só o link de setup resolve). Scope `numbers:write`.
6193
+ */
6194
+ resubscribeWebhooks(id) {
6195
+ return this.client.requestItem("POST", `/phone_numbers/${enc6(id)}/webhook-subscription`);
6196
+ }
6165
6197
  };
6166
6198
  function enc6(id) {
6167
6199
  return encodeURIComponent(id);