API Asender

Cada ferramenta é um sistema à parte, com a API dela num endereço próprio e uma página própria. 612 operações em 5 APIs publicadas, 5 a caminho.

Por que endereços separados. Uma API global faz de qualquer pane um evento sistêmico. Aqui o CRM fora do ar é o CRM fora do ar: quem integra com páginas não percebe, e quem usa uma ferramenta não é afetado pela outra. As ferramentas compartilham identidade e se integram entre si — mas falham separadamente.
Quer integrar? Comece pelo mapa de integrações: todos os meios (API, OAuth, MCP, webhooks, SMTP/IMAP, navegador, DNS, conversões), quando usar cada um e como autenticar.
É um agente que está lendo? Pegue tudo de uma vez em llms-full.txt — guias, todas as operações e todos os schemas em um arquivo de texto. O índice curto está em llms.txt, e a especificação unificada em openapi.json.

As APIs

CRM

Jornadas, alertas, destinos e integrações de conversão. Sistema próprio, endereço próprio.

https://api.crm.asender.net

Sessão OIDC + X-Asender-Tenant (sem API key) · 116 operações

E-mail

Envio transacional (e OTP) por /v1/emails com API key, gestão de domínios e caixas, mensagens, rascunhos, contatos e assinatura.

https://api.mail.asender.net

API key (Bearer sk_…) · 75 operações

Identidade (OIDC / OAuth 2.1)

Authorization Server. É daqui que sai o token que todas as outras APIs exigem.

https://auth.asender.net

OAuth 2.1 + PKCE · 13 operações

Páginas

Páginas, formulários, redirects, mídia — e a analytics do que foi publicado. Inclui o runtime que serve e mede o publicado.

https://api.pages.asender.net

API key / sessão · 170 operações

Plataforma

Contas, membros, convites, API keys e plano — e a mensageria pública por API key. É a API da plataforma, não de um produto.

https://api.asender.net

API key (/v1) + sessão OIDC/OAuth 2.1 (/api) · 238 operações

A caminho

Atendimento em breve

Caixa de entrada de atendimento: conversas, timeline, estado, atribuição, filas e equipe. A API própria desta ferramenta ainda não é aberta a integradores.

Hoje, pela API pública (https://api.asender.net): ler conversas e mensagens em GET /v1/conversations e GET /v1/conversations/{id}/messages (escopo conversations:read) e responder pelos canais da caixa com POST /v1/telegram/send, /v1/whatsweb/send e /v1/telegramconta/send (escopos telegram:send, whatsweb:send e telegramconta:send).

E-mail Marketing em breve

Campanhas e templates de e-mail marketing, com supressão, limite de envio e cota. A API própria desta ferramenta ainda não é aberta a integradores.

Hoje, pela API pública (https://api.asender.net): enviar e-mail com POST /v1/emails/send e /v1/emails/batch (até 500 mensagens), consultar envios em GET /v1/emails, e ler campanhas e relatórios de e-mail em GET /v1/campaigns e GET /v1/reports/email/*. Escopos: email:send, email:read e campaigns:read.

Push em breve

Web Push: aparelhos inscritos, envio com supressão, limite de envio e cota. A API própria desta ferramenta ainda não é aberta a integradores.

Hoje, pela API pública (https://api.asender.net): enviar push com POST /v1/push/send, registrar e listar aparelhos em POST e GET /v1/push/devices (do navegador do visitante, com a chave pk_push_ em POST /v1/push/site/devices) e ler mensagens e o panorama em GET /v1/messaging/push/messages e GET /v1/messaging/push/reports/overview. Escopos: push:send, push:devices e messaging:read.

SMS em breve

Campanhas e envio de SMS, com supressão, limite de envio e cota. A API própria desta ferramenta ainda não é aberta a integradores.

Hoje, pela API pública (https://api.asender.net): enviar SMS com POST /v1/sms/send e ler mensagens e o panorama em GET /v1/messaging/sms/messages e GET /v1/messaging/sms/reports/overview. Escopos: sms:send e messaging:read.

WhatsApp em breve

Envio de WhatsApp (API oficial), com templates, supressão, limite de envio e cota. A API própria desta ferramenta ainda não é aberta a integradores.

Hoje, pela API pública (https://api.asender.net): enviar WhatsApp (texto livre ou template) com POST /v1/whatsapp/send e ler mensagens e o panorama em GET /v1/messaging/whatsapp/messages e GET /v1/messaging/whatsapp/reports/overview. Escopos: whatsapp:send e messaging:read.

Primeira chamada

Toda API exige uma credencial. As integrações de máquina usam uma API key da conta (crie uma na Platform API); o painel usa a sessão OIDC do usuário. A chave vai em Authorization: Bearer, e o tenant é sempre resolvido da credencial — nunca de um campo do corpo.

curl 'https://api.asender.net/v1/account' \
  -H 'Authorization: Bearer sk_live_...'

Coleções paginam por cursor; escrita aceita Idempotency-Key. O guia de convenções detalha o contrato comum, e cada página de API traz o que é específico dela (erros, limites, exemplos).

Guias

Integrações: todos os meios

O mapa de tudo o que dá para integrar com a Asender: API REST, APIs por ferramenta, Entrar com Asender (OAuth), MCP, webhooks, SMTP/IMAP, navegador, DNS, conversões e conectores — quando usar cada um e como autenticar.

Chaves de API e escopos

Como criar, escopar, girar e revogar chaves de API (sk_live_ e sk_test_), e quais escopos cada rota exige.

Webhooks

O formato único de webhook da Asender (v1): cabeçalhos, assinatura, verificadores em Node, Python, Go e PHP, cadastro por emissor e API /v1/webhooks, tentativas e idempotência.

No navegador: formulário, pixel, chat e push

Embed de formulário, pixel de analytics, chat, web push e o SDK @asender/pages-sdk: o que colar no site e que chave usar.

Domínios e DNS

Domain Connect e os registros DNS (SPF, DKIM, DMARC, verificação) para enviar e publicar no seu domínio.

SMTP e IMAP com senhas de app

Conectar clientes de e-mail e sistemas legados por SMTP e IMAP com senhas de aplicativo: hosts, portas, autoconfig.

Conversões e conectores

Enviar conversões para Meta, Google e TikTok e entregar leads a sistemas externos (Kommo, HTTP próprio).

Servidor MCP

Conectar agentes de IA à Asender pelo Model Context Protocol: endereço, autenticação e ferramentas.

Aplicativos (OAuth)

Cadastrar e gerenciar seu aplicativo de "Entrar com Asender" no painel: credenciais, escopos, revisão e testadores.

Alias de e-mail

Vários endereços entregando na mesma caixa: como o alias funciona, a ordem de entrega no recebimento e o uso entre domínios da mesma conta.

Convenções da API

Autenticação, formato de requisição e resposta, erros, paginação, idempotência, webhooks e limites.

Entrar com Asender (apps de terceiro)

Como um app de terceiro autentica usuários Asender com 1 clique e lê dados da conta com escopos: authorization code + PKCE, consentimento, refresh com rotação, revogação, erros e sincronização incremental com a API pública.

Páginas: o JSON do documento v2

Guia completo para criar, editar e publicar páginas por API (e por agentes de IA): modelo mental, todos os campos de todos os itens, validação e erros, mídia, fluxos seguros, receitas e prompt pronto.