mailtrap-managing-contacts
Ajuda seu agente a gerenciar contatos no Mailtrap. Permite organizar listas, segmentos e importar dados para campanhas de e-mail.
O que ela faz
Essa ferramenta ajuda a gerenciar sua lista de contatos de marketing. Você pode adicionar, atualizar ou importar contatos, organizar eles em listas e adicionar informações extras como nome e empresa.
Quando usar
- ✓Quando você precisa adicionar muitos contatos de uma vez.
- ✓Para organizar seus contatos em grupos específicos (listas).
- ✓Para adicionar informações personalizadas a cada contato, como nome ou empresa.
Exemplo do que pedir para a IA
“Importe 100 contatos do meu arquivo CSV para a lista 'Clientes VIP' e adicione o campo 'Empresa'.”
Quer saber mais? Abra as seções abaixo.
Como usar
O jeito mais fácil: copie a mensagem abaixo e cole no Claude, ChatGPT, Cursor ou outra IA. Ela lê a skill e segue as instruções.
Link da skill
Mensagem pronta para colar
Como funciona
A ferramenta se conecta à sua conta do Mailtrap e usa comandos para adicionar, remover ou atualizar informações dos seus contatos. Ela pode fazer isso individualmente ou em grandes lotes.
Instalação
Jeito mais fácil: copie o link da skill e cole no Claude, ChatGPT ou Cursor pedindo para seguir as instruções.
No terminal (Claude Code, Codex, Cursor), na pasta do projeto:
npx skills add sickn33/agentic-awesome-skills --skill mailtrap-managing-contactsOu baixe só o arquivo:
curl -L https://raw.githubusercontent.com/sickn33/agentic-awesome-skills/main/plugins/agentic-awesome-skills-claude/skills/mailtrap-managing-contacts/SKILL.md -o SKILL.mdConteúdo técnico (SKILL.md)
Tradução do texto original do autor no GitHub. Os comandos e códigos estão como no original.
Gerenciando contatos do Mailtrap
Visão geral
Antes de gerar corpos de requisição de API: verifique a Especificação OpenAPI de Contatos para nomes de campos atuais, parâmetros obrigatórios e estruturas aninhadas.
Contatos são o banco de dados de marketing: listas, segmentos, campos personalizados e importações para audiências de campanhas e fluxos de trabalho relacionados. A API de Contatos automatiza a criação/atualização e pode alimentar a sincronização de CRM ou CDP (seu código, ou ferramentas como Zapier, Make, n8n — veja Importar contatos).
Supressões (hard bounces, reclamações de spam, cancelamentos de inscrição no lado de envio) residem no produto de envio e bloqueiam a entrega para esses endereços em seus fluxos. Isso é aplicado separadamente dos filtros de marketing (segmentos, associação a listas, sinalizadores de consentimento) que decidem quem é elegível para campanhas. Para bloqueios do lado de envio, veja Supressões e mailtrap-sending-emails.
Habilidades relacionadas: mailtrap-sending-emails (caminhos de envio ao vivo).
Quando usar
- Gerenciamento programático de contatos (criar, atualizar, importação em massa)
- Sincronização com CRMs ou data warehouses
- Limpeza de lista de contatos e importação de CSV
- Atualização de contatos com campos personalizados ou disparo de eventos personalizados para automações
- Segmentos e campos personalizados para construção de audiência
Autorização
Todos os endpoints abaixo precisam de Authorization: Bearer $MAILTRAP_API_TOKEN e um $MAILTRAP_ACCOUNT_ID no caminho. Resolva $MAILTRAP_ACCOUNT_ID a partir de GET https://mailtrap.io/api/accounts e armazene tokens em variáveis de ambiente ou em um gerenciador de segredos.
Endpoints (substitua os placeholders)
| Ação | Método | URL | Referência |
|---|---|---|---|
| Criar / obter / atualizar / excluir contato | vários | https://mailtrap.io/api/accounts/$MAILTRAP_ACCOUNT_ID/contacts |
Contatos |
| Importação em massa (job assíncrono) | POST |
https://mailtrap.io/api/accounts/$MAILTRAP_ACCOUNT_ID/contacts/imports |
Importação em massa |
| Listas de contatos | vários | https://mailtrap.io/api/accounts/$MAILTRAP_ACCOUNT_ID/contacts/lists |
Listas de contatos |
| Campos personalizados | vários | https://mailtrap.io/api/accounts/$MAILTRAP_ACCOUNT_ID/contacts/fields |
Campos de contato |
| Eventos personalizados | POST |
https://mailtrap.io/api/accounts/$MAILTRAP_ACCOUNT_ID/contacts/{contact_identifier}/events |
Eventos de contato |
| Exportar contatos | vários | https://mailtrap.io/api/accounts/$MAILTRAP_ACCOUNT_ID/contacts/exports |
Exportar contatos |
- Limite de taxa (típico): 200 requisições por 60 segundos por conta — prefira a importação em massa para grandes volumes.
- Limite de importação em massa: até 50.000 contatos por requisição de importação (job assíncrono); consulte o status da importação com
GET .../contacts/imports/{import_id}. Veja Importação em massa.
Exemplos (curl)
Criação de contato único (com campos personalizados)
curl -X POST "https://mailtrap.io/api/accounts/$MAILTRAP_ACCOUNT_ID/contacts" \
-H "Authorization: Bearer $MAILTRAP_API_TOKEN" \
-H 'Content-Type: application/json' \
-d '{
…
Perguntas frequentes
O que são 'listas' e 'campos personalizados'?
Listas são grupos de contatos que você cria, como 'Newsletter' ou 'Clientes'. Campos personalizados são informações extras que você pode adicionar a cada contato, como 'Nome', 'Sobrenome' ou 'Empresa'.
Posso importar contatos de um arquivo?
Sim, você pode importar contatos em massa de um arquivo, como um CSV, para suas listas.
Essa ferramenta envia emails?
Não, esta ferramenta gerencia apenas os contatos. Para enviar emails, você precisaria usar outra ferramenta como 'mailtrap-sending-emails'.
Detalhes
Descrição original do autor
Manage Mailtrap contacts, lists, segments, custom fields, imports, CRM syncs, and campaign audiences through the UI or API.
Popularidade
- Estrelas no GitHub
- 48 mil
- Posição no ranking
- #3519
- Licença
- MIT
- Atualizada em
- 15/10/2026
Comentários
- …
Mais skills deste repositório
00-andruia-consultant
Ajuda seu agente a iniciar ou melhorar projetos de IA. Ele analisa código, sugere ferramentas e cria planos de ação em espanhol.
sickn33/agentic-awesome-skills
007
Faz seu agente realizar auditorias de segurança e modelagem de ameaças. É útil para proteger projetos contra ataques e vulnerabilidades.
sickn33/agentic-awesome-skills
10-andruia-skill-smith
Ajuda seu agente a criar ou melhorar ferramentas de IA. Ele define como as ferramentas funcionam, escreve a documentação e valida a estrutura.
sickn33/agentic-awesome-skills
20-andruia-niche-intelligence
Faz seu agente criar um resumo sobre um setor específico. É útil para entender o contexto, regras, padrões de uso e riscos de um projeto, usando fontes confiáveis.
sickn33/agentic-awesome-skills
Skills parecidas
operator-approval-loop
Faz seu agente gerenciar o envio de mensagens com aprovação humana. Garante que mensagens importantes sejam revisadas antes de serem enviadas.
affaan-m/ECC
discernment-nudge
Faz seu agente adicionar perguntas de acompanhamento após dar uma resposta importante. É útil para garantir que você pense bem sobre conselhos ou planos antes de agir.
anthropics/skills
interview-me
Faz perguntas para entender exatamente o que você precisa. Garante que o agente compreenda sua real necessidade antes de começar o trabalho.
addyosmani/agent-skills