@polymorfa/sdk é o SDK de servidor da Polymorfa para TypeScript e JavaScript.
Ele não tem dependências de runtime e inclui as próprias definições de tipo.
Requisitos
- Node.js 20 ou mais recente, ou um Cloudflare Worker no servidor, Deno ou Bun.
O runtime precisa oferecer
fetchecrypto.subtle. - Uma chave da equipe (
pmfa_…) ou uma credencial de projeto (pmfa_pt_…). Crie uma em Chaves de API.
Instale
dev. Ainda não
existe uma versão estável. A flag de versão exata registra a versão resolvida,
como 0.1.0-dev.20261001215108, para que toda instalação receba o mesmo código.
Faça commit do seu lockfile.
A tag dev muda a cada nova prerelease publicada. Leia as
notas de versão antes de atualizar.
Faça sua primeira solicitação
Guarde sua chave na variável de ambientePOLYMORFA_KEY e liste seus Números:
sessions:read.
Envie uma mensagem
messages:write. O Número precisa estar conectado. Veja
Envie e receba mensagens para mídia, modelos
e respostas.
Use um runtime de edge
Importe da raiz do pacote,@polymorfa/sdk, em Cloudflare Workers, Deno e Bun.
Guarde as chaves no armazenamento de segredos do runtime, não no código-fonte.
@polymorfa/sdk/node contém helpers de download de arquivos que precisam do
Node.js. Não importe esse módulo em código de edge.
Veja Verifique um webhook
para um Worker que recebe webhooks.
Próximos passos
- Crie um cliente: escolha o cliente certo e defina timeouts, novas tentativas e a versão da API.
- Erros e novas tentativas: trate falhas e leia todas as páginas de uma lista.
- Conecte e gerencie Números: conecte uma conta do WhatsApp com o QuickLink.
- Análises: leia engajamento, resultados de chamadas e intervalos de atividade, ou exporte métricas de coletores.