Um tempo limite não informa se a criação falhou. Seu sistema precisa relacionar a solicitação do cliente à caixa criada. Separe criação, encaminhamento e disponibilidade para que uma interrupção não leve o usuário a clicar em Criar de novo sem conhecer o resultado.
Você pode deixar um programa criar caixas e configurar encaminhamentos pela API do TrekMail. A API permite que seu sistema envie comandos ao serviço, sem que alguém repita os passos no painel. Essas alterações exigem Pro ou Agency, permissões adequadas e acesso ao domínio escolhido.
Defina o que precisa ser criado
Comece descrevendo a tarefa de forma simples. “A pessoa precisa de uma caixa de trabalho” e “mensagens para um endereço geral devem ir para outra caixa” exigem configurações diferentes.
Uma caixa completa guarda suas próprias conversas. Você pode configurar encaminhamento e decidir se ela mantém uma cópia local. Um endereço de encaminhamento sem caixa serve para receber em um endereço e enviar adiante sem manter um arquivo próprio ali. As condições e os limites dessas opções diferem.
Separe também administração do serviço e acesso ao conteúdo. Criar um endereço não exige automaticamente ler as conversas dos funcionários. Mensagens fazem parte de outras funções da API. Não dê leitura a um programa que só cria caixas.
Registre essas diferenças antes do desenvolvimento. Quem implementa saberá qual recurso criar e qual resultado deve aparecer no painel.
Prepare o plano e um acesso limitado
Poder configurar algo manualmente não significa ter direito de alterá-lo por API. Criar caixas e modificar encaminhamentos exige Pro ou Agency. Starter permite ler a configuração de infraestrutura disponível, mas não basta para essa automação.
Crie um acesso específico para o programa. Limite ações e domínios. Se a agência atende várias empresas, a integração de um cliente deve operar apenas sobre os recursos dele.
Os direitos de quem autoriza também importam. A pessoa não pode dar ao programa mais poderes do que possui. A referência de permissões da API explica autorizações e limites por plano.
Guarde a chave na configuração do servidor da integração. Não a mostre no formulário de cadastro nem a envie no e-mail de boas-vindas. O usuário precisa apenas do resultado claro: endereço criado e forma de começar.
Organize a sequência de criação
Busque o domínio permitido nos seus dados do cliente. Um identificador enviado pelo navegador não comprova que o domínio pertence a ele.
Depois confira se o endereço já existe e se há espaço nos limites. Se a caixa estiver criada, descubra se corresponde à mesma solicitação. Um clique repetido não deve deixar o processo em um estado confuso.
Após criar, configure o encaminhamento quando previsto. Em uma caixa completa, decida antes se deve existir cópia local. Se a pessoa espera manter um arquivo ali, não deixe essa opção ao acaso.
Se a caixa existe e o encaminhamento falhou, registre o resultado parcial e corrija essa etapa. Marque como pronto só depois de verificar entrega e cópia local.
A visão geral da API TrekMail descreve métodos e formatos. Ela serve de especificação para o desenvolvedor, enquanto o processo do usuário permanece simples.
Preveja repetições e falhas
Numa operação documentada como idempotente, mantenha a mesma Idempotency-Key para a mesma solicitação e conteúdo. Salve o ID retornado e confira as regras de repetição das outras operações.
Nos demais casos, a integração deve verificar se o recurso apareceu. Não repita a criação indiscriminadamente após qualquer resposta inesperada. Guarde a relação entre solicitação e resultado para continuar do passo correto.
Trate separadamente falta de espaço, limite esgotado e acesso negado. Repetir a mesma chamada não resolve essas causas. É melhor mostrar uma explicação e quem pode corrigir do que deixar “Criando caixa” sem fim.
Em operações em lote, não prometa o mesmo tempo para todos. Mostre o estado de cada pedido e a lista de casos que precisam de atenção.
Teste em um domínio
Comece com um domínio de teste e alguns endereços. Confira a criação normal, a repetição da solicitação e uma tentativa de acessar um domínio fora da autorização.
Envie uma mensagem ao endereço criado. Se houver encaminhamento, confira o destino final e a cópia local conforme o modo escolhido. Uma resposta bem-sucedida da API não substitui o teste do correio.
Antes de ativar, combine quem verá as falhas e poderá corrigi-las manualmente. Guarde um registro de solicitações sem chaves nem senhas. Quando esse processo pequeno funcionar de forma previsível, inclua-o na entrada de funcionários ou clientes.
Use a referência da API. Criar a estrutura não exige ler as mensagens do novo usuário; conceda apenas os direitos necessários.