Programa Builders

Construa com a gente por um mês inteiro. Uso e add-ons ilimitados, chamadas semanais e seu próprio canal no Slack.

Saiba mais
Polymorfa

QuickLink

Um link conecta o número do próprio cliente

Pare de guiar clientes pelo pareamento. Crie um link hospedado com uma chamada de API e envie. Eles confirmam o número, conectam por QR code, código de pareamento ou Embedded Signup, e o número entra no seu projeto.

Começar a construirLer o guia do QuickLink
Formas de conectar: QR, código de pareamento, Embedded Signup
3
Por quanto tempo um link fica aberto
Até ser usado
Status que você pode consultar
6
Idiomas da página, inglês e português
2

Como funciona

Nenhuma tela de pareamento no seu build.

A Polymorfa hospeda a página que confirma o telefone e faz o pareamento. Seu código cria o link e lê o resultado.

  1. Crie o link. Uma chamada retorna uma URL que fica aberta até o número conectar ou você cancelar.
  2. Eles conectam. Quem está com o celular confirma o número e depois escaneia um QR code, digita um código de pareamento ou conclui o Embedded Signup.
  3. Você recebe o número. Ele entra no seu projeto. O link passa a connected, a página volta para a sua URL de sucesso e session.connected é disparado.

Browser Tunnel

Pareamento pela rede do próprio cliente.

O WhatsApp verifica a rede de onde um novo aparelho conectado faz o pareamento, e endereços de data center podem falhar nessa verificação. O QuickLink envia o handshake de pareamento pelo navegador de quem recebe o link, então ele sai da conexão dessa pessoa.

O handshake sai da conexão do cliente
  • Funciona com QR codes e códigos de pareamento
  • O navegador repassa frames criptografados e nunca guarda as chaves
  • Nada para instalar para quem faz o pareamento

Rotas que você permite

Escolha a rota ou deixe o cliente escolher.

Defina uma conexão preferida por link e se ela é só uma preferência ou a única rota permitida.

Preferir ou forçar uma rota. A rota preferida aparece primeiro e maior. Force a rota e a página abre direto nela, sem escolha a fazer.
Números oficiais pelo Embedded Signup. Os clientes conectam o próprio número da Meta Cloud API e pagam a Meta diretamente pelas mensagens. Com a Coexistência, eles mantêm o app WhatsApp Business, e o histórico de conversas chega como eventos de webhook.

Suas regras

O número certo, na sua página.

Trave o telefone esperado, teste sem um número real, aplique sua marca à página e leve as pessoas de volta ao seu app.

Trave o telefone esperado. Preencha o número e desative a troca de telefone. Qualquer outra conta falha com phone_mismatch, mesmo depois de escanear o QR. Celulares brasileiros são reconhecidos com ou sem o nono dígito.
Links de número de teste no Free. O mesmo fluxo hospedado conecta um número simulado. Quem recebe vê que ele é simulado, e você escolhe até três campos que a pessoa pode editar.
Sua marca, no idioma do cliente
  • Nome da empresa, título, logo, cor de destaque, tema e cantos
  • Inglês ou português do Brasil, conforme o idioma do navegador
  • O QuickLink com marca própria remove o Powered by Polymorfa e usa o seu próprio app da Meta
Retornos com motivo. A página volta para a sua URL de sucesso ou de falha com o status e o motivo. Confirme com uma leitura de status ou com os webhooks de sessão.

No seu código

Onboarding em poucas linhas.

Crie o link onde o seu onboarding já acontece e reaja quando o número conectar. Números reais exigem uma equipe Pay-As-You-Go. Links de número de teste funcionam no Free.

Ler o guia do QuickLinkDocumentação do SDKDocumentação da CLI
connect.ts
import { MessagingClient } from "@polymorfa/sdk";

const messaging = new MessagingClient({
  credential: { type: "apiKey", value: process.env.POLYMORFA_KEY! },
});

const created = await messaging.quickLinks.create(
  {
    projectId,
    externalId: "crm-account-42",
    configuration: {
      prefillPhone: "+5511912345678",
      connectionPreference: "linked",
      connectionEnforcement: "prefer",
      methods: ["qr", "pairing"],
    },
  },
  { idempotencyKey: "connect-crm-account-42" },
);

await sendToAccountOwner(created.data.data.url);

Superfície da API

A API do QuickLink.

Criar, ler e cancelar links exige quicklink:manage. Texto da página, marca e retornos são configurações salvas na Platform API.

Documentação do QuickLink

Links

  • POST/messaging/quicklinksCriar um link para um número
  • GET/messaging/quicklinks/{id}Ler o status
  • DELETE/messaging/quicklinks/{id}Cancelar o link
  • GET/messaging/quicklinks/availabilityVerificar se um número pode adicionar uma conexão
  • POST/messaging/{session}/cloud-credentials/reauthorizeRenovar credenciais da Meta com um novo link
  • PUT/platform/quicklinkSalvar texto da página, marca e retornos

Eventos de webhook

  • Eventosession.connectedO novo número está online
  • Eventosession.statusA conexão do número mudou
  • Eventohistory.syncHistórico de conversas do número conectado
  • Eventocustomer.pairing_link.connectedO link de pareamento de um cliente conectou

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 construirVer preços