Ajuda para quem já está integrando

Suporte CrieBase

Atendimento em português · segunda a sexta, 9h às 18h (BRT)

01 · Antes de abrir um ticket

O gateway sabe dizer sozinho o que está faltando na sua integração. Chame o diagnóstico com a sua API key e leia as pendências — cada uma vem com a instrução do que fazer:

curl -H "Authorization: Bearer $BASE_API_KEY" \
  https://baseapi.criebase.com.br/api/v1/diagnostics

Se pronto vier false, a lista de pendencias traz o código do problema, a dica imperativa e o link da documentação. Esse é o caminho mais rápido — inclusive mais rápido que nós.

02 · Canais

• E-mail: contato@criebase.com.br — canal oficial, com registro de histórico. É o que recomendamos para qualquer assunto técnico.
• Incidente em produção (mensagens não saem, webhook parado, número fora): mande o e-mail com URGENTE no assunto.
• Cobrança e assinatura: o próprio console tem “Gerenciar assinatura”, onde você troca cartão, vê faturas e cancela sem depender de nós.

03 · O que enviar

Ticket com estes quatro itens costuma ser resolvido na primeira resposta. Sem eles, a primeira resposta é só um pedido de informação — e você perde um ciclo:

• project_id (aparece no console) e o caso de uso envolvido — WhatsApp, Instagram ou Anúncios;
• o request_id e o corpo do erro que a API devolveu, na íntegra;
• o horário aproximado (com fuso) e se o problema é constante ou intermitente;
• se está em sandbox (chave bsk_test_) ou em produção — muda completamente o diagnóstico.

Nunca envie a sua API key, tokens ou senhas. Não precisamos deles para investigar, e chave que circula por e-mail é chave a ser rotacionada.

04 · Prazos de resposta

• Produção parada — resposta em até 4 horas úteis, com atualização enquanto durar o incidente.
• Erro que bloqueia integração (não está em produção ainda) — até 1 dia útil.
• Dúvida, orientação de uso, pedido de recurso — até 2 dias úteis.

Prazos valem para clientes com assinatura ativa, contados dentro do horário de atendimento. Contrato com condições próprias prevalece sobre esta página.

05 · Respostas rápidas

Meu número foi banido ou restringido. Se você veio de API não oficial (Baileys, Evolution, Z-API e afins), o histórico daquele número pesa. Banimento é decisão da Meta e quem contesta é o dono da conta, pelo Gerenciador de Negócios; nós ajudamos a montar a contestação e a conectar outro número enquanto isso. Vale a prevenção: opt-in real, template na categoria certa e nada de disparo em massa para lista comprada.

Meu template foi rejeitado. A rejeição vem com motivo da Meta e nós repassamos cru, sem interpretar por cima. As causas mais comuns são categoria errada (marketing enviado como utility), variável em posição inválida e texto que promete o que a política não permite. Corrigir e reenviar costuma resolver no mesmo dia.

O webhook não chega. Confira nesta ordem: a URL cadastrada responde 200 rapidamente? Você está validando a assinatura com o segredo do projeto? O endpoint está acessível de fora (sem VPN, sem IP bloqueado)? O console mostra as últimas entregas com o código de resposta — geralmente o erro aparece ali. Para ensaiar sem depender da Meta, use POST /api/v1/webhooks/simulate.

A API respondeu 403. É a cesta de casos de uso: o projeto não tem aquele caso de uso vigente. O código diz qual é a situação — use_case_not_contracted, use_case_expired ou use_case_blocked — e o console resolve os três.

06 · Documentação

As receitas executáveis, a referência de erros e o guia para agentes ficam em casos de uso. Se você usa Claude Code, Codex ou outro agente, aponte ele para https://criebase.com.br/llms-full.txt — está escrito para ser lido por máquina, e é o caminho mais curto do zero à primeira mensagem.