Use este guia quando você precisar configurar, entender ou validar **Como configurar SSL da central de ajuda** na IAra.

## Antes de começar na IAra

- Confirme que seu usuário tem permissão para acessar a área citada no artigo.
- Faça a configuração primeiro em um cenário de teste, sempre que o recurso afetar atendimentos reais.
- Se o fluxo envolver WhatsApp, Meta, Twilio, e-mail, domínio, SAML, API ou outro provedor externo, confirme as credenciais e permissões antes de iniciar.

## Guia detalhado

Usar seu próprio domínio, como docs.sua-empresa.com, faz com que sua central de ajuda pareça mais confiável e de marca. IAra permite que você use seu próprio domínio personalizado e o ajudará a proteger seu site com certificados SSL para que seja seguro para seus visitantes.

Este guia orienta você na configuração de um domínio personalizado para o portal da Central de Ajuda na IAra.

*TLDR: Adicione seu domínio personalizado nas configurações do portal IAra, atualize seu DNS com o CNAME fornecido pela IAra e emitiremos o certificado SSL. Quando estiver pronta, sua Central de Ajuda estará ativa e acessível aos seus clientes.*

### Etapa 1: Configure seu domínio personalizado nas configurações do portal

Faça login no painel da IAra e vá para a Central de Ajuda que deseja conectar ao seu domínio personalizado. Clique em **Configurações** e vá até a seção **Domínio personalizado** . Clique no botão **Adicionar domínio personalizado** para iniciar a configuração.

Agora você verá um prompt solicitando seu domínio personalizado. Insira o domínio onde você deseja que sua Central de Ajuda esteja disponível (por exemplo, `docs.seudominio.com`). Este é o endereço do site que seus clientes visitarão para acessar sua documentação.

A seguir, serão mostradas as configurações de DNS que você precisa adicionar para que possamos confirmar se o domínio é seu e conectá-lo à sua Central de Ajuda. Você precisará copiar essas informações e atualizar seu provedor de DNS adequadamente.

Se não tiver certeza de como fazer isso, você pode usar a opção na tela para enviar esses detalhes por e-mail ao seu desenvolvedor.

### Etapa 2: atualize seu DNS com o registro CNAME

Você deve apontar seu domínio personalizado para IAra criando um registro CNAME.

Anfitrião: documentos
Tipo: CNAME
Valor: iara.help

As instruções variam de acordo com o provedor de DNS:

#### Usando Cloudflare:

Você pode encontrar a configuração na guia “DNS”.

Observação: certifique-se de que o modo de criptografia SSL esteja definido como Completo no Cloudflare (você pode ver isso em SSL/TLS -> Visão geral).

#### Usando AWS Route 53:

Você pode encontrar a configuração no serviço "Route53".

Se você estiver usando um provedor DNS diferente, as etapas geralmente serão as mesmas. Procure a seção de configurações de DNS e adicione um registro CNAME conforme descrito. Se você não tiver certeza de como fazer isso, procure instruções específicas para seu provedor usando uma frase como *Como adicionar um registro CNAME em [seu provedor de DNS]*.

Esta etapa vincula seu domínio aos servidores da IAra. Feito isso, teremos tudo o que precisamos, os dados do seu portal e a configuração do domínio para emitir o certificado SSL e colocar sua Central de Ajuda no ar.

### Etapa 3: obter um certificado SSL

IAra fornece certificados SSL para todos os contatos de nuvem em planos pagos que configuram um domínio personalizado para o portal da Central de Ajuda.

Esta etapa acontece automaticamente. Depois de adicionar o registro CNAME ao seu DNS, nosso servidor verificará o domínio e começará a emitir o certificado SSL. Isso geralmente leva apenas alguns minutos, mas em alguns casos, dependendo do seu provedor de DNS e de quanto tempo leva para atualizar os registros, pode levar de 24 a 48 horas.

Você pode rastrear o status do seu certificado SSL diretamente no painel da IAra. Inicialmente, você verá o status como **Aguardando verificação**. Isso significa que ainda estamos confirmando a configuração do seu domínio antes da emissão do certificado.

Se houver algum problema durante o processo de verificação SSL, como um registro CNAME incorreto ou atrasos na propagação de DNS, você verá uma mensagem de erro ao lado do status em seu painel. Passe o mouse sobre o indicador de status para ver mais detalhes sobre o que deu errado e o que você precisa corrigir. Isso ajuda você a identificar e resolver rapidamente quaisquer problemas no processo de configuração.

Assim que a verificação for bem-sucedida e o certificado SSL for emitido, o status mudará para 'Ativo' no seu painel. Isso significa que sua Central de Ajuda agora está disponível com segurança em seu domínio personalizado. Seus clientes podem visitar o URL e navegar pelo conteúdo.

---

## Como validar na IAra

1. Execute o fluxo em uma conta ou conversa de teste.
2. Confirme se o resultado aparece para o agente, gestor ou cliente exatamente como esperado.
3. Revise se o nome da caixa, time, etiqueta, assistente ou integração está claro para o restante da equipe.

## Problemas comuns

- Usuário sem permissão para acessar a configuração.
- Nome de tela diferente entre versões ou contas.
- Recurso dependente de plano, provedor externo ou habilitação pela Digi2B.
- Falta de teste em conversa realista antes de liberar para a equipe.

## Checklist final

- [ ] Configuração revisada por um administrador.
- [ ] Teste realizado com dado ou conversa controlada.
- [ ] Impacto para agentes e gestores entendido.
- [ ] Artigos relacionados revisados para evitar links quebrados.