Pular para o conteúdo principal
@polymorfa/sdk é uma prerelease de desenvolvimento. Uma prerelease pode mudar um método ou o formato de uma resposta. Esta página lista as mudanças que exigem ação quando você atualiza, das mais recentes para as mais antigas. Cada versão se chama 0.1.0-dev.<timestamp>, então você pode comparar a sua com as versões abaixo. Verifique a versão instalada com npm ls @polymorfa/sdk ou leia a exportação SDK_VERSION.

5 de outubro de 2026

Conteúdo e sequências de campanhas

A partir de 0.1.0-dev.20261005230914, as solicitações de criação e atualização de campanhas aceitam variableMapping e trackedLinks, messaging.campaigns.update aceita templateId, platform.campaigns.create e update tipam messagesArray como CampaignMessage[], e LaunchCampaignRequest aceita skipMissingVariables. Os registros Campaign incluem trackedLinks, e os destinatários de campanhas incluem messagesSent, nextMessageAt e sequenceError. A versão também adiciona messaging.campaigns.update, reschedule e exportRecipients, e platform.audiences.createFromCampaign. Se o seu código constrói (build) objetos Campaign ou CampaignRecipient, adicione os novos campos. Veja Campanhas.

Confirmações de STOP

A partir de 0.1.0-dev.20261005233122, os clientes da organização expõem optOuts.getConfirmationSettings, updateConfirmationSettings e getConfirmationSummary.

1º de outubro de 2026

Rascunhos de Fluxos retornam o rascunho em response.data

A partir de 0.1.0-dev.20261001124422, flows.list e flows.retrieve retornam os rascunhos diretamente em response.data. As versões de 0.1.0-dev.20260926213449 a 0.1.0-dev.20260927174827 os retornavam em response.data.data. Substitua response.data.data por response.data ao atualizar. Veja Fluxos.

Janelas de envio de campanhas

A partir de 0.1.0-dev.20261001124422, messaging.campaigns.create, platform.campaigns.create e platform.campaigns.update aceitam sendWindow, e os registros de campanhas o incluem. O SDK exporta CampaignSendWindowRequest e CampaignSendWindow. Veja Campanhas.

26 de setembro de 2026

Leituras de rascunhos de Fluxos

0.1.0-dev.20260926213449 adicionou flows.list e flows.retrieve aos clientes de projeto.

22 de setembro de 2026

whatsapp_ids substitui whatsapp_id

A versão 2026-09-22 da API retorna as referências de mensagens do WhatsApp em whatsapp_ids, em linked_devices, official_api ou ambos. Os recibos de mensagens e os tipos de webhook do SDK incluem esse campo. O campo singular whatsapp_id está obsoleto e só continua existindo enquanto versões mais antigas da API forem compatíveis. Leia whatsapp_ids em código novo. Veja IDs de mensagem.

20 de setembro de 2026

Operações

O SDK adicionou operations.list, get, listTransitions, wait e cancel. Veja Eventos e operações.

Setembro de 2026

Mudanças de plano de Número usam uma cotação

sessions.setTierOverride(sessionId, { tierOverride }) foi substituído por uma cotação e uma confirmação. Chame sessions.quoteTierChange, mostre a cotação e depois passe o ID dela como setTierOverride(sessionId, { quoteId }). Leia o resultado com sessions.retrieveTierChange. Veja Altere o plano de um Número.

Configurações de alerta de saldo removidas

billing.updateReminderSettings foi removido, e as respostas de cobrança não incluem mais lowBalanceThresholdCents nem reminderChannels. Configure os alertas de saldo no Console, em Minhas notificações. Os valores em créditos nos saldos, no uso e nas claims do BanSafe podem ter até seis casas decimais, incluindo campos cujo nome termina em Cents. Não os interprete como inteiros. sessions.create e sessions.createTesting foram removidos. Crie Números com messaging.quickLinks.create. As alterações de configurações de Números usam sessions.update com uma revision e configuration.set ou configuration.reset. Veja Conecte e gerencie Números. Os helpers de navegador widget.start e widget.status também foram removidos.