> ## Documentation Index
> Fetch the complete documentation index at: https://docs.truthlocks.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Domínios personalizados

> Configure URLs de marca para seu portal de verificação e console com configuração de domínio personalizado e verificação de DNS.

Domínios personalizados permitem que você sirva o portal de verificação e o console do Truthlocks a partir do seu próprio domínio. Em vez de `verify.truthlocks.com`, seus usuários veem `verify.yourdomain.com`.

> [!NOTE]
>
> Domínios personalizados estão disponíveis em todos os planos. Navegue até **Configurações > Domínios**
> no console para começar.

## Tipos de domínio

Truthlocks suporta dois tipos de domínios personalizados:

| Tipo | Propósito | Exemplo |
| :- | :- | :- |
| **Verificação** | Portal de verificação público onde destinatários e auditores verificam atestações | `verify.yourdomain.com` |
| **Console** | Console administrativo para sua equipe | `console.yourdomain.com` |

Você pode configurar um ou ambos os tipos, dependendo das suas necessidades.

## Configurando um domínio personalizado

**1. Abrir configurações de domínio**

Navegue até **Configurações > Domínios** na console.

**2. Adicionar um domínio**

Clique em **Adicionar Domínio**, selecione o tipo de domínio (Verificação ou Console) e
digite o nome do host que deseja usar (por exemplo, `verify.yourdomain.com`).

**3. Adicionar o registro DNS**

Truthlocks gera um token de verificação exclusivo para o seu domínio. Adicione um TXT
registro à sua configuração de DNS:

| Campo | Valor |
| :- | :- |
| **Tipo** | `TXT` |
| **Nome** | `_truthlocks-verify` |
| **Valor** | O token de verificação mostrado no console |

Copie o token usando o botão **Copiar** ao lado dele.

**4. Verificar o domínio**

Após adicionar o registro DNS, clique em **Verificar Registro DNS** no console.
Truthlocks verifica o registro TXT e atualiza o status do domínio.

> [!TIP]
>
> A propagação de DNS pode levar até 48 horas, embora a maioria dos provedores propague
> em minutos. Se a verificação falhar, aguarde alguns minutos e tente novamente.

## Status de domínio

Cada domínio progride por três status:

| Status | Significado |
| :- | :- |
| **Pendente** | O domínio foi adicionado, mas o registro DNS ainda não foi verificado. |
| **Verificado** | O registro DNS TXT foi encontrado e validado. O domínio se torna ativo automaticamente. |
| **Ativo** | O domínio está ativo e atendendo ao tráfego para seu locatário. |

## Gerenciando domínios via API

Você pode adicionar, listar e verificar domínios personalizados programaticamente.

### Listar domínios

```http Request theme={null}
GET /v1/settings/domains
X-API-Key: tl_live_...
```

```json Response theme={null}
{
  "domains": [
    {
      "id": "dom_abc123",
      "tenant_id": "tn_xyz789",
      "type": "VERIFY",
      "hostname": "verify.acme.com",
      "status": "ACTIVE",
      "verification_token": "tl-verify-abc123def456",
      "verified_at": "2026-03-25T14:30:00Z",
      "created_at": "2026-03-25T14:00:00Z"
    }
  ]
}
```

### Adicionar um domínio

```http Request theme={null}
POST /v1/settings/domains
X-API-Key: tl_live_...
Content-Type: application/json

{
  "type": "VERIFY",
  "hostname": "verify.acme.com"
}
```

O campo `type` aceita `VERIFY` para domínios de verificação ou `CONSOLE` para domínios de console. A resposta inclui o `verification_token` que você precisa para a configuração de DNS.

### Verificar um domínio

```http Request theme={null}
POST /v1/settings/domains/{domain_id}/verify
X-API-Key: tl_live_...
```

Retorna o objeto de domínio atualizado. Se o registro DNS não for encontrado, o status permanece `PENDING`.

## Exemplo: configuração completa

```bash theme={null}
# 1. Add the domain
curl -X POST https://api.truthlocks.com/v1/settings/domains \
  -H "X-API-Key: tl_live_..." \
  -H "Content-Type: application/json" \
  -d '{"type": "VERIFY", "hostname": "verify.acme.com"}'

# 2. Add the TXT record to your DNS (using your DNS provider)
# Name:  _truthlocks-verify
# Value: <verification_token from response>

# 3. Verify the domain
curl -X POST https://api.truthlocks.com/v1/settings/domains/dom_abc123/verify \
  -H "X-API-Key: tl_live_..."
```

## Solução de problemas

### A verificação continua falhando

1. Confirme se o nome do registro TXT é exatamente `_truthlocks-verify` (alguns provedores anexam o domínio automaticamente — verifique por duplicatas como `_truthlocks-verify.yourdomain.com.yourdomain.com`).
2. Aguarde a propagação do DNS. Use `dig TXT _truthlocks-verify.yourdomain.com` para confirmar que o registro está visível.
3. Certifique-se de que o valor TXT corresponda exatamente ao token mostrado no console, sem espaços extras.

### Domínio verificado, mas não ativo

Domínios verificados transitam para Ativo automaticamente. Se o status não for atualizado, atualize a página ou busque novamente via API.

## Relacionado

> [card] [Marca personalizada](https://docs.truthlocks.com/guides/enterprise-branding.md)
>
> Faça upload de logotipos e defina as cores da marca para páginas de verificação e e-mails.

> [card] [Entrega de e-mail](https://docs.truthlocks.com/security/email-delivery.md)
>
> Configure remetentes de e-mail personalizados e servidores SMTP.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.