O painel funciona bem para uma tarefa pontual de 20 contas. Ele é menos adequado quando um ambiente de homologação precisa de novas caixas a cada implantação ou quando o produto cria contas durante o onboarding de clientes. Para isso existe a API.
O plano anual oferece acesso REST para enviar tarefas, consultar o status e trazer resultados aos seus sistemas. Pipelines de CI, painéis administrativos e ferramentas internas são usos comuns. Não grave as credenciais retornadas em logs; transfira-as para um armazenamento aprovado.
O que costuma ser automatizado
- CI/CD: preparar 10 contas Gmail de teste quando uma branch de homologação é implantada
- Onboarding: provisionar caixas quando uma organização entra no produto
- QA: fornecer contas novas para testes do Playwright ou Selenium
- Operações internas: um botão para criar 50 contas Yahoo para um projeto específico
Fluxo básico de integração
- 1Assine o plano anual e gere uma chave em Painel → API
- 2Envie `POST /tasks` com provedor (`gmail`, `yahoo` ou `outlook`), quantidade e opções de nomes
- 3Salve imediatamente o `task_id` retornado
- 4Consulte `GET /tasks/{id}` a cada 30 a 60 segundos até o status ser `completed` ou `failed`
- 5Recupere a lista no endpoint de detalhes da tarefa e sincronize com o banco de dados
O resultado não é instantâneo
Não bloqueie a interface esperando. Uma tarefa de 50 contas Gmail pode levar de 30 a 90 minutos. Retorne o ID da tarefa e avise quando terminar por webhook, e-mail ou consulta feita pelo backend.
Segurança: requisitos obrigatórios
| Regra | Motivo |
|---|---|
| Chaves apenas no backend | Uma chave no frontend pode ser comprometida |
| Uma chave por ambiente | Um vazamento em homologação não compromete produção |
| Altere as chaves periodicamente | Limita o impacto de um vazamento |
| Criptografe senhas armazenadas | São dados confidenciais |
| Registre IDs de tarefas, não senhas | Permite depurar sem expor credenciais |
Quando algo dá errado
- Pode haver sucesso parcial. Confira o status por conta e repita as falhas em uma nova tarefa.
- Respeite os limites. Aumente o intervalo de espera de 30 para 60 e depois 120 segundos.
- Se uma tarefa ficar em `processing` por mais de três horas, registre e gere um alerta. Não suponha que falhou e crie uma duplicata.
- Salve o `task_id` antes de consultar. Se o script parar, retome a mesma tarefa em vez de iniciar outra.
Documentação da API
A referência dos endpoints, formatos de requisição e resposta e cabeçalhos de autenticação fica no painel, em Acesso à API, após a assinatura anual.
A criação é apenas a primeira etapa da automação. Use o guia de integração com ferramentas de prospecção para a transferência às plataformas de envio e o fluxo de provisionamento de contas para aprovação, responsáveis, armazenamento e encerramento.