Ambientes

Produção e sandbox, separados pela credencial e garantidos pelo banco.

A Amivu tem dois ambientes — produção e sandbox — e quem escolhe entre eles é a credencial, não a URL.

Um endereço, duas realidades

# produção
https://api.amivu.com.br/v1   +   amivu_live_...

# sandbox
https://api.amivu.com.br/v1   +   amivu_test_...

A URL é a mesma de propósito. Um endereço diferente por ambiente vira uma variável a mais para configurar errado — e o erro nunca aparece em teste, só na virada para produção. Com a chave decidindo, subir de teste para produção é trocar um segredo.

O que o isolamento garante

Não é convenção nem filtro de consulta: o isolamento é uma política do banco de dados. Cada contato e cada conversa carregam o ambiente em que nasceram, e a política compara esse valor com o escopo da requisição antes de qualquer linha ser devolvida.

Na prática:

Uma chave de teste que peça um contato real recebe 404, mesmo sabendo o id.
Uma chave de teste não consegue criar uma linha marcada como real.
O que o sandbox cria não aparece na caixa de entrada, nos relatórios nem nos disparos.

Por que isso importa mais do que parece

A saída fácil seria filtrar o ambiente em cada consulta. Ela funciona no dia em que é escrita e falha no primeiro lugar em que alguém esquece — e o sintoma é um contato de mentira aparecendo no atendimento de um cliente. Com a política no banco, esquecer fecha em vez de abrir.

O que o sandbox faz e não faz

Ele faz:

Aceita todas as rotas, com os mesmos formatos, os mesmos erros e a mesma paginação.
Cria contatos, conversas e mensagens de teste, isolados do resto.
Entrega webhooks de verdade nos endpoints cadastrados com chave de teste.

Ele não faz:

Não envia mensagem para ninguém. Uma mensagem de teste é registrada e percorre os estados de entrega, sem tocar em nenhum canal externo.
Não enxerga canais, contatos ou conversas de produção.
Não gasta conversa da Meta nem consome limite de nenhum provedor.

O sandbox pede assinatura ativa

Ele é um ambiente de desenvolvimento da sua conta, não um período de avaliação. Se a assinatura da organização deixar de estar ativa, as chaves já criadas param de responder — as duas, sandbox e produção — com 403 subscription_required. Se foi isso que aconteceu, o que falta não é escopo nem configuração — veja o código do erro.

Endpoints de webhook também são por ambiente: uma chave de teste lista e cadastra apenas os dela. Uma credencial de teste que enxergasse os endpoints vivos revelaria para onde os dados reais da organização saem.

Veja também Webhooks e Autenticação.

Escrevemos sobre operação de atendimento, canais e IA no blog da Amivu.