Ir para o conteúdo
Gerenciamento de API

Seu site, CRM ou sistema de pedidos envia WhatsApp pelo seu próprio número

Crie uma chave, escolha exatamente o que ela pode fazer, mapeie seus modelos uma vez e teste cada endpoint num playground antes de escrever código de produção. As requisições são assinadas em vez de autorizadas por um token pelado, cada chave tem suas próprias permissões e seu contador de uso, e o webhook tem botão de teste e registro de entregas — então uma falha de integração é algo que você enxerga, não algo que você desconfia.

Incluído emWiz BotWiz CampaignWiz Pro

Uma chave mais uma assinatura e um carimbo de tempo — não um único token bearer que vaza para sempre
Requisições assinadas
Permissões próprias, contador de uso próprio, gire o segredo ou revogue de vez
Controle por chave
Um playground e um botão de teste de webhook, antes de qualquer coisa chegar à produção
Teste antes

Para quem é

A empresa que tem desenvolvedor, ou a agência que liga o WhatsApp ao sistema existente de um cliente sem querer um projeto de duas semanas.

A dúvida que resolve

"Integração significa um projeto de duas semanas de desenvolvimento." Um assistente cria a chave e o mapeamento de modelo, o playground prova que funciona, e o gerador de trechos entrega código que já roda.

Como integrar

  1. Rode o assistente de configuração

    Ele cria a chave e o primeiro mapeamento de modelo juntos, para você não costurar à mão duas coisas meio configuradas.

  2. Escolha as permissões

    Uma chave precisa ter ao menos uma — uma chave sem nenhuma não consegue enviar nada, e a interface diz isso em vez de falhar em silêncio depois.

  3. Aponte o webhook para algum lugar

    Configure seu endpoint, clique em testar e leia o registro de entregas para confirmar o que chegou.

  4. Experimente e pegue o trecho

    Chame os endpoints no playground e depois gere um trecho de código funcional para o modelo que você configurou.

Chaves feitas para serem operadas, não só emitidas

A maioria dos concorrentes te dá uma chave global e um PDF. Aqui cada chave é um objeto gerenciado com ciclo de vida próprio.

  • Permissões granulares por chave, com ao menos uma obrigatória
  • Gire o segredo de uma chave sem destruir a chave
  • Desative uma chave temporariamente, ou revogue de vez
  • Uso por chave: chamadas de hoje, último uso, total de chamadas e quantas chaves estão ativas
  • Mapeie um modelo para uma chave uma vez só, para que as chamadas que o usam fiquem curtas
  • Um assistente que cria a chave e o mapeamento de modelo numa etapa só

Prove que funciona antes de subir

Dois recursos existem só para encurtar o ciclo entre escrever uma integração e confiar nela. O playground chama os endpoints reais pelo painel, então você vê o formato da resposta antes de escrever uma linha de código. O webhook tem botão de teste e registro de entregas, então quando respostas ou eventos de entrega não chegam você consegue dizer se o problema é nosso, da rede ou do seu endpoint — em vez de adivinhar.

O que você pode enviar

Texto, mídia, modelos, um envio simplificado de modelo para o caso comum, listas interativas, botões interativos e reações. Junto disso: consultar o status de uma mensagem, enviar mídia e baixá-la de volta.

  • Mensagens de texto e mídia
  • Mensagens de modelo, além de um envio simplificado para um modelo já mapeado
  • Listas e botões interativos
  • Reações
  • Consulta de status de mensagem
  • Upload e download de mídia

Bom saber

Até onde este recurso vai, em palavras claras — para que nada aqui surpreenda você depois da contratação.

  • O painel precisa de assinatura ativa. As chamadas de API passam ainda por uma verificação de direito, com um curto período de tolerância após um lapso, para que um cartão vencido não derrube sua integração na mesma hora.
  • A autenticação é uma chave mais uma assinatura HMAC e um carimbo de tempo, não um token bearer simples. Isso dá mais trabalho para quem integra, e é proposital — uma chave vazada sozinha não basta para enviar em seu nome.
  • As requisições têm limite de ritmo por chave.
  • Mídia em formato livre precisa de uma sessão aberta de 24 horas com o destinatário. Fora dela, use um modelo.
  • Reações só valem para mensagens dos últimos 30 dias e precisam do identificador de mensagem do próprio WhatsApp, não de um interno. Envie um emoji vazio para remover uma reação.
  • Variáveis de modelo se ligam por nome quando nomeadas e por número quando posicionais — não pela ordem em que aparecem no texto. Renomear uma variável nomeada quebra os envios que a usam, e um cabeçalho aceita no máximo uma variável.
  • Girar um segredo invalida as assinaturas existentes. Só a revogação apaga a chave em si.

Incluído em

Este recurso faz parte dos planos abaixo.

  • Wiz Bot
  • Wiz Campaign
  • Wiz Pro
Comparar planos e preços
FAQ

Perguntas frequentes

Como faço a autenticação?

Com uma chave de API mais uma assinatura sobre a requisição e um carimbo de tempo. É um pouco mais de trabalho que um token pelado, e é justamente esse o ponto: uma chave sozinha não basta para alguém enviar mensagens como você.

Posso testar antes de escrever código?

Pode. O playground chama os endpoints reais pelo painel, e o webhook tem botão de teste com registro de entregas.

O que acontece se minha assinatura vencer?

As chamadas de API têm uma verificação de direito com um curto período de tolerância, então uma renovação falha não quebra sua integração de produção em silêncio na mesma hora.

Posso dar acesso limitado a uma chave?

Pode — as permissões são por chave, e cada chave precisa ter ao menos uma. Você também pode girar o segredo dela, desativá-la temporariamente ou revogá-la.

Como sei o quanto uma chave está sendo usada?

Cada chave mostra as chamadas de hoje, quando foi usada pela última vez e o total de chamadas.

Já construí sobre a Cloud API da Meta. Preciso reescrever?

Não — veja o recurso de alternativa à Cloud API. Ele espelha as rotas e formatos de requisição da própria Meta, então o código existente continua funcionando depois de trocar host e token.

Ligue o WhatsApp ao que você já usa

Crie uma chave, teste no playground e leve o trecho de código.

Ver planos

Explore Mais Funcionalidades

Descubra outras ferramentas que fazem do WizMessage a plataforma completa de WhatsApp.