Mailcheck

Visão geral

O Mailcheck é um serviço de verificação de e-mail que ajuda empresas a validar endereços antes do envio, garantindo entregabilidade e reduzindo taxas de bounce. Com a integração no SquadOS, seus agentes podem verificar e-mails em tempo real e validar domínios quanto a registros MX, serviços de e-mail temporário e indicadores de spam — diretamente em qualquer fluxo automatizado.

• Documentação na Composio: docs.composio.dev/toolkits/mailcheck

Autenticação

Esta ferramenta utiliza chave de API (API_KEY) para conectar.

Você vai precisar dos seguintes campos:

Campo	Obrigatório	Descrição
api_key	Sim	Chave de API gerada no painel da sua conta Mailcheck, usada para autenticar todas as requisições.

Como obter a credencial

1. Acesse app.mailcheck.co e crie ou faça login na sua conta.
2. No painel, navegue até a seção API ou Settings → API Keys.
3. Gere uma nova chave de API e copie o valor exibido.

Dica

Guarde a chave de API em local seguro. Ela autentica todas as requisições e está vinculada ao saldo de créditos da sua conta.

Como conectar no SquadOS

1. Acesse Ferramentas no menu lateral (/admin/tools).
2. Abra a aba Disponíveis e procure por Mailcheck.
3. Clique no card para abrir o modal de detalhes e em Conectar.
4. Você é levado para a página de conexão segura hospedada pela Composio, onde informa a chave de API obtida acima.
5. Ao concluir, você volta para o SquadOS com a conta conectada e a ferramenta disponível para os agentes. (Detalhes do fluxo em Ferramentas da Organização.)

Ações disponíveis

Validar domínio

MAILCHECK_VALIDATE_DOMAIN

Valida um domínio quanto à descartabilidade, registros MX, idade do domínio e indicadores de spam. Use ao verificar se um domínio está associado a serviços de e-mail temporário, provedores de e-mail públicos ou serviços de encaminhamento.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
domain	string	Sim	O domínio a validar (ex: example.com).

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Verificar endereço de e-mail

MAILCHECK_VERIFY_EMAIL

Verifica um endereço de e-mail fornecido. Use após obter o e-mail do usuário como entrada.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
email	string	Sim	O endereço de e-mail a verificar.
accept_role	boolean	Não	Se deve aceitar endereços de e-mail baseados em função (ex: admin@empresa.com).
accept_disposable	boolean	Não	Se deve aceitar domínios de e-mail descartáveis.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.