Os grandes modelos de linguagem não se limitam mais a conversar. Com tool use, function calling e o Model Context Protocol, eles se transformaram em agentes que agem — e uma das ações mais valiosas que podem executar é enviar um e-mail ou um SMS em seu nome. Este guia pilar mostra como conectar Claude, GPT, Gemini ou qualquer agente de IA moderno às APIs Mailpro™ para que entreguem mensagens reais em caixas de entrada reais e celulares reais.
Resumo
- A Mailpro™ oferece três APIs que um agente de IA pode chamar: Email v2, CRM v3, SMS.
- Cada endpoint está documentado em nosso portal do desenvolvedor com exemplos prontos em mais de 20 linguagens de programação.
- Use Email v2 para envios simples e campanhas, CRM v3 para o ecossistema completo de contatos e integrações, SMS para mensagens curtas e OTPs.
- Agentes de IA integram via HTTPS + JSON padrão — nenhum SDK proprietãrio exigido.
Por que dar ao seu agente de IA o poder de enviar e-mails e SMS?
Do chatbot à ação: a virada das IAs agentivas
Até pouco tempo, uma conversa com um LLM terminava no prompt. O modelo escrevia um rascunho, um resumo ou um trecho de código, e a última milha era sua. Com tool use (termo da Anthropic), function calling (termo da OpenAI) ou o Model Context Protocol (padrão aberto emergente), o modelo agora decide chamar uma função externa — e seu código executa a chamada. De repente, o agente pode consultar um registro, calcular algo, e enviar uma mensagem.
Essa última parte — o envio — é onde a IA deixa de ser brinquedo e vira processo de negócio. Um agente que responde a um ticket de suporte é legal. Um agente que responde e envia a solução por e-mail é uma hora de equipe economizada.
Quatro casos de uso concretos
- Envio transacional inteligente. O agente redige uma confirmação de pedido personalizada, um follow-up promocional ou um e-mail de reset de senha, e dispara pela API Email v2 Mailpro™.
- Campanhas orientadas a eventos. Dê ao agente um brief de campanha e uma lista-alvo: ele escreve o texto, agenda o envio e devolve o ID da campanha.
- Higiene de CRM em escala. O agente lê dados de leads bagunçados, limpa, marca com tags, atribui a um segmento — tudo via API CRM v3 Mailpro™.
- OTP sob demanda. O agente pede um código de uso único por SMS pela API SMS para verificar um usuário no meio de uma conversa.
Em cada caso, o agente não "substitui" você — ele fecha o ciclo entre decidir e agir.
As APIs Mailpro™ em 30 segundos
A Mailpro™ expõe três APIs REST, cada uma desenhada para um papel preciso. Um agente pode usar uma, duas ou as três no mesmo fluxo. Todas estão em api.mailpro.com e documentadas em nosso portal do desenvolvedor, com exemplos de código copiáveis em mais de 20 linguagens (cURL, Python, Node.js, PHP, Go, Ruby, C#, Java, Swift, Kotlin e muitas outras).
| API | Formato | Ideal para |
|---|---|---|
| Email API v2 | JSON + XML | Envios de e-mail simples, campanhas, listas de e-mails |
| CRM API v3 | JSON (snake_case) | Ecossistema completo de contatos, tags, segmentos, integrações de terceiros |
| SMS API | JSON + XML | SMS unitários ou em massa, listas de números, créditos |
Email API v2 — simples e direta para enviar
Precisa de e-mail e SMS em um só lugar? Os planos do Mailpro dão ao seu agente de IA os dois canais por uma única API — uma integração, uma conta previsível.
A mais direta das três. Se você só quer enviar um e-mail — transacional pontual ou campanha para uma lista — a API Email v2 é a menor distância entre seu agente e a caixa de entrada do destinatário. Gerencia listas de e-mails, modelos HTML, endereços de remetente, campanhas e estatísticas. Respostas em .json to Mailpro™ é visível tanto em v2 quanto em v3. Nada impede seu agente de usar v3 para criar um contato bem taggueado, depois v2 para enviar um e-mail, depois a API SMS para mandar um lembrete.
Exemplo mínimo: Claude envia um e-mail para sua lista VIP
O padrão mais limpo é expor um wrapper fino em volta da API Mailpro™ como ferramenta que o agente pode chamar. Aqui a versão mínima em Python com o SDK da Anthropic:
import anthropic
import requests
ANTHROPIC_KEY = "sk-ant-..."
MAILPRO_ID = 123456 # YOUR_ID_CLIENT
MAILPRO_KEY = "YOUR_API_KEY" # nunca envie esta chave ao modelo
client = anthropic.Anthropic(api_key=ANTHROPIC_KEY)
# 1. Declarar a ferramenta
tools = [{
"name": "send_email_campaign",
"description": "Envia uma campanha de e-mail a uma lista Mailpro.",
"input_schema": {
"type": "object",
"properties": {
"list_id": {"type": "integer", "description": "ID da lista Mailpro"},
"subject": {"type": "string"},
"html": {"type": "string", "description": "Corpo HTML completo"}
},
"required": ["list_id", "subject", "html"]
}
}]
# 2. Pedir ao Claude a campanha
msg = client.messages.create(
model="claude-sonnet-4-5",
max_tokens=1024,
tools=tools,
messages=[{
"role": "user",
"content": "Escreva um e-mail de promoção de primavera para a lista VIP (ID 42) e envie."
}]
)
# 3. Executar a chamada à ferramenta
for block in msg.content:
if block.type == "tool_use" and block.name == "send_email_campaign":
args = block.input
r = requests.post(
"https://api.mailpro.com/v2/send/campaign.json",
params={"IdClient": MAILPRO_ID, "ApiKey": MAILPRO_KEY},
data={
"AddressBookId": args["list_id"],
"Subject": args["subject"],
"Body": args["html"]
}
)
print("Resposta Mailpro:", r.json())
Dois pontos-chave: a chave API fica no seu código (nunca no prompt), e o agente só vê a forma da ferramenta — não precisa de credenciais para fazer seu trabalho. Esse é o alicerce de qualquer padrão de integração agentiva. Para ver a mesma chamada em outra linguagem, a documentação da API Email v2 oferece o snippet equivalente em Node.js, PHP, Go, Ruby, C# e cerca de vinte outras.
Segurança e boas práticas para o envio guiado por IA
Sistemas agentivos são rápidos e se espalham. Um loop mal configurado pode disparar milhares de mensagens indesejadas em minutos. Quatro regras:
Nunca exponha sua chave API diretamente ao LLM
O modelo deve receber o esquema da ferramenta, não as credenciais. Mantenha a chave em variáveis de ambiente no servidor e só a injete no momento da execução.
Respeitar os limites de taxa
A Mailpro™ aplica por padrão 500 requisições por minuto por chave API. Um agente que roda em loop agressivo bate esse teto rápido. Use backoff exponencial em respostas 429 e prefira endpoints em lote quando possível. Para mais, veja nosso guia de entregabilidade de e-mail.
Respeitar descadastros e opt-outs
Quando um contato está descadast"https://pt.mailpro.com/precos/">preços.
Quais modelos de IA funcionam com a API Mailpro?
Qualquer modelo que suporte function calling ou tool use: Anthropic Claude, OpenAI GPT-4/5, Google Gemini, Mistral, e modelos locais via Ollama ou LM Studio. A API é HTTP + JSON, o modelo só precisa emitir uma chamada a ferramenta JSON válida.
É seguro deixar um agente de IA enviar e-mails sozinho?
Sim, com proteções: limite o escopo da chave API, imponha rate limits do seu lado, mantenha logs de auditoria, e adicione confirmação humana para envios sensíveis (campanhas em massa, destinatários em domínios desconhecidos).
O Mailpro e a API do Mailpro
Uma API para o seu agente de IA enviar e-mail e SMS
Dê ao seu agente de IA uma única API do Mailpro e ele alcança clientes por e-mail e SMS — uma integração, um painel, uma conta. Veja quanto custa manter os dois canais.
