# Modo de teste

Chaves de teste com dados de exemplo: integre sem tocar nos seus dados reais nem esperar aprovação.

Guia Sem aprovação Dados de exemplo

**Como no Stripe.** Integre com o ByDomu sem tocar nos seus dados reais nem esperar aprovação. Cada conta tem um modo de teste.

## Chaves de teste

Em _Configurações › Chaves de API_ escolha **Teste** e crie uma chave: `domu_sk_test_…` (secreta, para seu servidor) ou `domu_pk_test_…` (publicável, para seu site). Têm todas as permissões (escritas, mensagens e webhooks) sem solicitar acesso, também durante o teste grátis; basta ter o e-mail verificado. Limite: 100 requisições e 30 escritas por minuto.

## Sua organização de teste

Com sua primeira chave de teste criamos uma organização de teste com dados de exemplo: contatos, compromissos, tarefas e conversas, e também imóveis e negócios se sua conta for imobiliária. Não há dados pessoais reais. Uma chave de teste só vê e altera essa organização, e uma chave de produção nunca a vê.

## Como saber em que modo você está

Cada resposta traz o cabeçalho `X-Domu-Mode: test` (ou `live`), e `GET /v1/me` devolve `"mode": "test"` e `"livemode": false`.

```bash
curl https://api.bydomu.com/v1/me -i \
  -H "X-API-Key: $BYDOMU_API_KEY"

# X-Domu-Mode: test
# { "data": { "mode": "test", "livemode": false, … } }
```

## Nada sai de verdade

- A organização de teste não envia WhatsApp, Instagram, Facebook, e-mail, SMS nem notificações.
- Também não há cobranças, publicações em portais ou Meta Ads, nem chamadas à IA.
- As mensagens ficam salvas como enviadas e seu id começa com `wamid.sim_`.

## Webhooks

São entregues igual à produção, com a mesma assinatura `X-Domu-Signature` e as mesmas novas tentativas. O envelope leva `"livemode": false`; os de produção, `"livemode": true`. Para testar seu receptor sem esperar um evento real:

```bash
curl -X POST https://api.bydomu.com/v1/test/events \
  -H "X-API-Key: domu_sk_test_…" -H "Content-Type: application/json" \
  -d '{"type":"deal.won"}'
```

O evento sai com os dados do registro mais recente desse objeto na sua organização de teste e traz `"test": true`.

## Começar do zero

`POST /v1/test/reset` (com uma chave secreta de teste) ou o botão _Reiniciar dados de teste_ apaga tudo e recarrega os dados de exemplo. Suas chaves, o id da organização e seus webhooks são mantidos.

```bash
curl -X POST https://api.bydomu.com/v1/test/reset \
  -H "X-API-Key: domu_sk_test_…"
```

## Ir para produção

Troque a chave por uma `domu_sk_live_…` e confira no seu receptor de webhooks que `livemode` seja `true`. As operações `/v1/test/*` respondem `403 TEST_MODE_ONLY` com chaves de produção.

## MCP

O servidor MCP aceita `domu_sk_test_…` igual a uma chave live; o assistente só verá os dados de exemplo.