Clientes

Opere o WhatsApp para cada empresa que você atende

Para plataformas de software e agências. Cada empresa recebe um registro de cliente, um link de pareamento que não exige conta, o próprio limite mensal e um token só para os números dela.

Começar a construir Ler o guia de Clientes

Onboarding

Do cadastro a um número conectado.

Crie o cliente no seu próprio fluxo de cadastro, envie o link e deixe um webhook avisar quando o número estiver ativo.

Crie o cliente. Guarde nele o ID da conta no seu sistema, pela Platform API ou pelo Console.
Envie o link de pareamento. A empresa escaneia um QR code ou digita um código no próprio celular. Ela não precisa de conta na Polymorfa.
Receba o evento de conexão. Depois envie e receba mensagens no número pela API de mensagens, como em qualquer outro número.

Controle

Cada cliente na sua própria faixa.

Limite quanto cada cliente gasta, decida quem é financiado primeiro, mova números e distribua tokens que alcançam um único cliente.

Um limite mensal compartilhado. Todos os números de um cliente usam um único limite de créditos. Zero bloqueia novas cobranças, e os limites reiniciam no dia 1º em UTC. Limites exigem Pay-As-You-Go.

Ordem de financiamento. Ordene clientes e números. Quando o crédito fica curto, as posições mais altas garantem a próxima renovação antes dos gastos das posições mais baixas e de novos pareamentos.

Mova um número. Transfira-o para outro cliente informando a origem e confirmando. Os gastos anteriores ficam com o cliente original.

Tokens restritos ao cliente. Emita um token de navegador de curta duração para até 64 números de um cliente. Um número movido para outro cliente retorna 403 na hora.

Links de pareamento

Links que você pode bloquear e revogar.

Cada link abre a sua página QuickLink hospedada, com um prazo de validade, um celular esperado opcional e webhooks a cada mudança.

Status que você acompanha

Gerado, aberto, conectando, conectado
Depois de uma falha, dá para tentar novamente no mesmo link
Validade de 15 minutos a 7 dias

Bloqueado para um celular

Defina o celular esperado em cada link
Um celular confirmado como fora do WhatsApp é recusado logo de início
Três divergências revogam o link

Sua marca na página

Seu nome, logo e cor de destaque
Seu domínio próprio e sem o rodapé da Polymorfa no QuickLink com marca própria
Conecte números Cloud API com o seu próprio app da Meta

Conhecer o QuickLink

No seu código

Clientes no seu próprio produto.

Crie clientes e links de pareamento no seu onboarding, mantenha seus registros em dia por webhooks e dê ao app de cada cliente o próprio token.

Ler o guia do SDK Documentação do SDK Documentação da CLI

customer.ts

import { Client } from "@polymorfa/sdk";

const platform = new Client({
  credential: { type: "organizationApiKey", value: process.env.POLYMORFA_KEY! },
});

const customer = await platform.customers.create(
  { projectId, name: "Northside Gym", externalCustomerId: "crm_456" },
  { idempotencyKey: "create-customer-crm_456" },
);

Superfície da API

A API de Clientes.

As rotas de clientes exigem customers:read ou customers:manage, e os limites exigem billing:manage. O envio continua na API de mensagens. Ativar Clientes em um projeto não pode ser desfeito.

Referência da Platform API

Rotas

POST/platform/customersCrie um cliente com o seu próprio ID
POST/platform/customers/{id}/pairing-linksCrie um link; a URL é retornada uma única vez
DELETE/platform/customers/{id}/pairing-links/{linkId}Revogue um link
POST/platform/customers/{id}/numbers/{sessionId}/transferMova um número para este cliente
GET/platform/customers/{id}/eventsLeia os eventos recentes do ciclo de vida
PUT/platform/billing/controls/customer/{id}Defina o limite mensal e a prioridade
POST/platform/client-tokensEmita um token para os números de um cliente
POST/messaging/{session}/messages/sendEnvie pelo número de um cliente

Eventos de webhook

Eventocustomer.createdUm cliente foi adicionado
Eventocustomer.archivedUm cliente foi arquivado
Eventocustomer.pairing_link.openedO destinatário abriu um link
Eventocustomer.pairing_link.connectedUm número verificado se conectou
Eventocustomer.pairing_link.failedUma tentativa falhou
Eventocustomer.number.attachedUm número entrou no cliente
Eventocustomer.number.transferredUm número passou de um cliente para outro
Eventocustomer.number.disconnectedO número de um cliente se desconectou

Comece com um número grátis

Seu primeiro número real é grátis. Adicione mais números no Pay-As-You-Go.

Começar a construir Ver preços