Migração

Migre da Z-API em uma tarde. Pague um terço.

Comparativo factual entre Z-API e Zapixo. Preço Z-API: R$ 100,00/instância/mês (verificado em 2026-07-04).

Calculadora de economia

Z-API / ano

R$ 1.200,00

Zapixo / ano

R$ 588,00

Economia

R$ 612,00

Equivalência endpoint a endpoint

RecursoZ-APIZapixoObservações
Enviar textoPOST /instances/{id}/token/{token}/send-textPOST /api/v1/messages/textZ-API: body `{ phone, message }`. Zapixo: `{ number, text, instance }` + header `Authorization: Bearer zpx_...`
Enviar mídiaPOST /instances/{id}/token/{token}/send-imagePOST /api/v1/messages/mediaZ-API usa endpoints separados por tipo. Zapixo unifica em `/media` com campo `mediatype`.
Status da instânciaGET /instances/{id}/token/{token}/statusGET /api/v1/instances/{name}/statusZapixo usa nome da instância no path, não ID numérico.
QR code / conectarGET /instances/{id}/token/{token}/qr-code/image Painel web /painel/instancias/{id}No Zapixo o QR é exibido no painel (polling). Não há endpoint público de QR — reduz superfície de ataque.
Webhook de recebimentoPOST Configurado na Z-API por instânciaPOST Webhook configurado no painel da instânciaFormato do payload difere (Evolution vs Z-API). Use o adaptador ou reconfigure o parser.
Verificar número WhatsAppGET /phone-exists/{phone} /ferramentas/validador-numero-whatsappFerramenta gratuita no site. Via API: contate-nos para casos de alto volume.

Adaptador de código

Troque a base URL no dia 1 sem reescrever toda a integração.

/**
 * Adaptador Z-API → Zapixo
 * Troque a base URL e use esta função no lugar das chamadas Z-API.
 */
const ZAPIXO_BASE = process.env.ZAPIXO_BASE_URL ?? "https://zapixo.com.br";
const ZAPIXO_KEY = process.env.ZAPIXO_API_KEY!;

export async function zapiToZapixo(
  action: "send-text" | "send-image",
  zapiPayload: { phone: string; message?: string; image?: string; caption?: string },
  instance: string
) {
  if (action === "send-text") {
    const res = await fetch(`${ZAPIXO_BASE}/api/v1/messages/text`, {
      method: "POST",
      headers: {
        Authorization: `Bearer ${ZAPIXO_KEY}`,
        "Content-Type": "application/json",
      },
      body: JSON.stringify({
        instance,
        number: zapiPayload.phone,
        text: zapiPayload.message ?? "",
      }),
    });
    return res.json();
  }

  const res = await fetch(`${ZAPIXO_BASE}/api/v1/messages/media`, {
    method: "POST",
    headers: {
      Authorization: `Bearer ${ZAPIXO_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      instance,
      number: zapiPayload.phone,
      mediatype: "image",
      media: zapiPayload.image,
      caption: zapiPayload.caption,
    }),
  });
  return res.json();
}

Checklist em 6 passos

  1. 1Crie sua conta no Zapixo (trial de 3 dias, sem cartão)
  2. 2Crie uma instância e escaneie o QR no painel
  3. 3Gere uma chave API em /painel/chaves
  4. 4Substitua a base URL da Z-API e use o adaptador (ou ajuste os campos manualmente)
  5. 5Envie uma mensagem de teste para seu próprio número
  6. 6Confirme webhooks e automações, depois cancele a Z-API

FAQ da migração

Perco meu número ao migrar?
Não. O número continua no seu celular. Você só desconecta da Z-API e conecta no Zapixo escaneando um novo QR — o WhatsApp permite uma sessão Web por vez.
Preciso reescanear o QR?
Sim, uma vez. Cada provedor cria sua própria sessão WhatsApp Web. A migração leva cerca de 2 minutos.
Os webhooks são iguais?
Não exatamente. O formato do payload difere. Se você usa n8n/Make, troque o parser ou use nossos templates prontos. Para webhooks custom, compare os campos no docs.
Posso rodar Z-API e Zapixo em paralelo?
Não no mesmo número — só uma sessão Web ativa por vez. Use números diferentes se precisar testar em paralelo.