O que a API devolve do cadastro que o painel não mostra
Resposta curta
Você salva a resposta da API do seu cadastro de teste e compara, campo por campo, com o que o painel mostra — a diferença é o que a sua automação de e-mail realmente recebe. São duas chamadas e uma tabela de quatro linhas, feitas hoje, com o que você já tem na conta.
Assunto: E-mail automático
Por Alan Victor · · 7 min de leitura
- 1Dispare um cadastro de teste e guarde a resposta inteira
- 2Abra o painel e procure o mesmo contato
- 3Compare os dois lado a lado numa tabela
- 4Force um erro de propósito e leia o que volta
- 5Escreva o e-mail de boas-vindas com o que você confirmou
No fim deste guia você tem o registro cru do último cadastro que entrou na sua lista, salvo em arquivo, e uma lista curta do que a tela do painel não mostra sobre ele. É esse arquivo que decide o texto do seu e-mail de boas-vindas, não o resumo que a tela desenha.
Na Systeme.io a página de captura, a lista e a automação de e-mail ficam no mesmo lugar, e é por isso que eu monto esse teste aqui em vez de juntar três ferramentas. A conta grátis abre pelo botão desta página, e a Etapa 1 é a primeira coisa que você faz dentro dela.
Sai um guia por dia, e o canal do Telegram avisa quando sai. A ferramenta que eu uso para a página, a captura e o e-mail automático no mesmo lugar é a Systeme.io, que tem plano gratuito.
O que você vai ter no fim
- O corpo da resposta da API do seu cadastro de teste em um arquivo, com o código de status anotado ao lado.
- Uma tabela de quatro linhas comparando o que o painel exibe e o que a API devolveu para o mesmo contato.
- A primeira regra da automação de boas-vindas revisada com base no que a API confirmou, com o contato de teste apagado no fim.
Etapa 1: Dispare um cadastro de teste e guarde a resposta inteira
Resposta direta: Você cria um contato pela API com a sua chave e salva o corpo da resposta em um arquivo, porque é o arquivo — e não a tela — que guarda o que a automação recebeu.
Pegue a chave de API nas configurações da sua conta na Systeme.io. O endereço do endpoint de contato fica na documentação oficial da API: copie de lá, porque ele muda com a versão e um endereço velho devolve um erro que parece erro seu.
O corpo mínimo costuma ser o e-mail. No exemplo eu usei o cabeçalho de autorização no formato Bearer; se o seu for outro, a documentação oficial da API diz qual é. Rode o comando com o seu endereço de teste no lugar do exemplo.
curl -s -o resposta.json -w "%{http_code}\n" \
-X POST "$ENDPOINT" \
-H "Authorization: Bearer $CHAVE" \
-H "Content-Type: application/json" \
-d '{"email":"teste@seudominio.com"}'O que você deve ver: um número sozinho na tela, 200 ou 201, e um arquivo resposta.json com um objeto JSON dentro. Abra o arquivo e leia inteiro antes de fechar.
Se voltar 401, a chave está errada ou veio com espaço no fim. Se voltar 404, o endereço do endpoint está incompleto. Se voltar 429, você chamou rápido demais e precisa esperar antes de repetir.
Se a chave de API ainda não estiver liberada na sua conta, o mesmo teste existe pelo formulário do painel: cadastre à mão e compare o que a tela mostra com o que a automação registrou. É mais lento e mostra menos, mas a diferença aparece igual.
Etapa 2: Abra o painel e procure o mesmo contato
Resposta direta: O painel confirma que o contato existe e em qual lista ele entrou, e para por aí — ele não devolve o corpo que você enviou nem o registro completo que ficou gravado.
Anote o que a tela mostra: e-mail, data, lista, etiquetas. São poucos campos, e é de propósito: a tela é um resumo para leitura rápida, não é o registro.
Agora abra o resposta.json ao lado e circule o que existe em um e não existe no outro. Essa é a comparação que o guia inteiro está montando.
Por que o painel mostra menos do que a API devolve?
Porque as duas respondem perguntas diferentes: a tela responde "esse contato entrou?", e a API responde "o que exatamente foi gravado neste registro?". A automação de e-mail trabalha com a segunda pergunta.
Identificador, data com fuso, etiquetas do momento do cadastro e status da inscrição são o que a regra usa para decidir o que enviar. Quando um e-mail de boas-vindas sai com o campo errado ou não sai, a resposta costuma estar aí.
Para fazer isso sem montar servidor
O que este guia faz por API, a Systeme.io faz por formulário: página, lista, etiqueta e e-mail automático na mesma conta. É a conta em que eu testo o que aparece aqui, e o plano gratuito já dá para publicar e capturar.
Etapa 3: Compare os dois lado a lado numa tabela
Resposta direta: Monte uma tabela de quatro linhas com o que você quer saber, o que o painel mostrou e o que a API devolveu; o que ficar em branco na coluna do painel é o que você acabou de descobrir.
| O que você quer saber | O painel mostra | A API devolve | Por que importa no e-mail |
|---|---|---|---|
| Identificador do contato | Não aparece na lista | Um número no campo de id | É o que localiza o contato quando dois têm o mesmo nome |
| E-mail exato gravado | Só o que cabe na coluna | A string inteira | Maiúscula, ponto e espaço sobrando quebram a entrega |
| Etiquetas do momento do cadastro | As de agora | As do registro | É a etiqueta gravada no cadastro que dispara a regra, não a que você pôs depois |
| Data e hora do cadastro | Data, sem fuso | Data e hora com fuso | Dois fusos trocados mandam o e-mail no dia errado |
Preencha a terceira coluna com o seu arquivo, não com o meu exemplo. Os nomes dos campos variam conforme a versão da API, e quem manda é o que voltou na sua chamada.
Etapa 4: Force um erro de propósito e leia o que volta
Resposta direta: Repita a mesma chamada com a chave errada e com um e-mail inválido, porque a mensagem de erro diz qual campo a automação não vai receber.
curl -s -o erro.json -w "%{http_code}\n" \
-X POST "$ENDPOINT" \
-H "Authorization: Bearer CHAVE-ERRADA" \
-H "Content-Type: application/json" \
-d '{"email":"teste@seudominio.com"}'O que você deve ver é o número 401 na tela, a linha de status 401 Unauthorized e um corpo curto dizendo que a autorização falhou. Copie a frase exata num bloco de notas: é ela que reaparece no dia em que a automação parar sem motivo aparente.
Agora volte para a chave certa e mande um e-mail sem arroba. O código fica na faixa de 400 ou 422 — os dois aparecem na prática, e o seu teste diz qual é o do seu caso. O ponto é o mesmo: um cadastro com erro ensina mais que dez com sucesso.
Etapa 5: Escreva o e-mail de boas-vindas com o que você confirmou
Resposta direta: Com os campos confirmados no arquivo, você monta a primeira mensagem da automação usando só o que existe de verdade no registro e apaga o contato de teste no fim.
Na Systeme.io a regra fica no mesmo lugar da lista e do e-mail: você escolhe o gatilho — contato entrou na lista, ou recebeu uma etiqueta — e a ação de enviar a mensagem. A documentação oficial da API cita "Tag added" como exemplo de gatilho e "Send email" como exemplo de ação; são exemplos, não uma receita, e a regra que você monta é a sua.
Ao escrever o texto, use apenas os campos que apareceram no seu resposta.json. Um campo inventado não dá erro na tela: ele só chega vazio na caixa de entrada de quem se cadastrou.
No fim, apague o contato de teste. Contato de teste em lista real entra na contagem e pode receber a automação de verdade.
Fazer isso hoje leva menos tempo do que ler sobre isso: uma chamada e uma tabela de quatro linhas. Cada dia sem essa conferência é um dia de e-mail de boas-vindas saindo no escuro, com visita que se cadastra e não recebe o que você escreveu. A conta na Systeme.io é o primeiro passo do guia — abra pelo botão desta página e faça a Etapa 1 enquanto o texto está aberto.
O que eu não vou afirmar
- Não vou afirmar que a sua resposta tem exatamente os campos do meu exemplo: os nomes variam com a versão da API, e quem manda é o arquivo que você salvou.
- Não vou afirmar que o painel esconde informação de propósito. Ele resume, e resumir é o trabalho dele.
- Não vou afirmar que o e-mail chega na caixa de entrada nem em quanto tempo sai: isso depende do seu domínio e do provedor de quem recebe.
- Não vou afirmar que a chave de API está liberada em todo plano; confira na sua conta. Se ainda não estiver, o teste pelo painel mostra metade da diferença, e o plano pago é o degrau seguinte de quem está crescendo.
Travou em alguma etapa?
Abra uma discussão em github.com/alanvito1/funil-simples dizendo em que passo parou. Dúvida que aparece mais de uma vez tem boa chance de virar guia, e o código deste site está no mesmo lugar, aberto.
Se ainda não tem onde publicar o que montou, a conta gratuita da Systeme.io resolve a página e a lista.
Perguntas frequentes
Dá para ver pela API o que o painel não mostra sobre um cadastro?
Dá, e é o caminho mais curto: a resposta da API traz o registro como ele foi gravado, com identificador, data com fuso e os campos que a tela resume. A tela responde se o contato entrou; a API responde o que ficou gravado nele.
Preciso saber programar para comparar painel e API?
Não. Uma chamada copiada e colada já devolve o corpo inteiro, e o trabalho de verdade é ler o arquivo e anotar o que a tela não mostrou. O comando é sempre o mesmo; muda só o e-mail de teste.
O que significa o código 401 na resposta?
Significa que a chave de API não foi aceita, normalmente por espaço sobrando na cópia, por chave de outra conta ou por cabeçalho de autorização ausente ou no formato errado. O corpo da resposta costuma dizer qual desses foi o caso.
Por que o contato aparece no painel e o e-mail de boas-vindas não chegou?
Porque o painel confirma o cadastro, não a entrega da mensagem. O cadastro pode ter entrado na lista e a mensagem ter sido barrada depois, e quem dá essa informação é o retorno do envio, não a tela de contatos.
Devo apagar o contato de teste depois da comparação?
Deve. Contato de teste em lista real entra na contagem e pode receber a automação de verdade, o que suja o número que você usa para saber se a página de captura está funcionando.
Leve isto com você
A sequência de boas-vindas, em três e-mails
É os três e-mails de boas-vindas que eu escrevi para este site, em texto, com o assunto, o atraso de cada um e o objetivo de cada um.
Cole cada um numa campanha da sua ferramenta de e-mail, na ordem. Troque a assinatura e o endereço, e a variável do link de saída pela que a sua ferramenta usa. Sem cadastro, sem e-mail: o arquivo baixa direto.
Receba o resto por e-mail
Eu testo ferramenta de funil e e-mail e mando o que descubro.