A primeira coisa que um desenvolvedor faz quando precisa de um e-mail automático é abrir a referência REST e procurar um método de envio. Não existe. Esse único método ausente leva as pessoas por dois caminhos errados — montar um cenário numa plataforma externa para algo que um fluxo resolve com um bloco só, ou dar a ação nativa como quebrada quando ela se recusa a rodar sem avisar. Os dois se evitam assim que você sabe onde o envio realmente acontece.

Existe um método da API REST para enviar e-mail?

Não. No Bitrix24 (Alaio) a família mailservice.* gerencia serviços de e-mail — criar, alterar, listar, excluir — e os métodos do Webmail gerenciam caixas, mensagens e destinatários. Nenhum deles coloca uma mensagem no ar. Conectar uma caixa e enviar são operações da interface, não da API.

crm.activity.add é o método que se encontra em seguida e se lê errado. Ele grava uma atividade de e-mail de saída na linha do tempo, e isso é contabilidade: o registro aparece no card do cliente tenha ou não chegado algo a uma caixa de entrada. Trate como entrada de log, não como envio.

Ou seja, há exatamente dois caminhos honestos para escrever a um cliente a partir da automação: a ação nativa dentro do fluxo, ou uma chamada HTTP a um provedor que envia por você. Tudo abaixo é um dos dois.

Como enviar um e-mail a partir de um fluxo?

A ação nativa se chama «Enviar e-mail ao cliente» e está disponível tanto para regras de automação quanto para processos de negócio. Ela precisa de quatro coisas: um endereço de remetente (uma caixa específica, ou seleção automática, que envia do endereço do responsável), o tipo de endereço do destinatário — comercial, pessoal, para newsletters ou automático —, um assunto e um corpo com os valores dos campos inseridos.

Três condições decidem se ela chega a rodar, e nenhuma levanta um erro que você fosse notar:

O responsável precisa ter uma caixa de e-mail conectada. Sem caixa, não há de onde enviar. O tipo de endereço na configuração precisa bater com o que existe de fato no card — escolha «comercial» quando só «para newsletters» está preenchido e o e-mail nunca sai. E quando vários contatos estão ligados a um negócio, só o primeiro recebe, com o contato tendo prioridade sobre a empresa.

Essa é a lista completa de falhas do caminho feliz, e explica a maioria dos chamados de «a automação está quebrada». Qual canal combina com qual evento está em notificações do processo de negócio; quando a regra nem sequer arranca, comece por a automação não roda.

E o SMS?

Mesmo formato, um requisito a mais: o portal não envia mensagens de texto sozinho. Ele as entrega a um aplicativo de provedor instalado do Market, que fala com a operadora. Sem provedor conectado, a ação fica na lista e não faz nada. O comprimento da mensagem é limitado, então textos longos são cortados ou cobrados como vários.

O tipo de telefone precisa bater com o card do mesmo jeito que o tipo de e-mail — escolha «comercial» quando só há um celular salvo e a mensagem é descartada. Normalize o número antes com Formatar telefone com prefixo: para a API de uma operadora, 020 7946 0958 e +44 20 7946 0958 são cadeias diferentes, e uma delas não será entregue.

Como enviar pelo seu próprio provedor?

Quando os canais nativos acabam — um serviço de e-mail transacional, um agregador de SMS mais barato, WhatsApp, Telegram — o envio vira uma chamada HTTP de saída de dentro do fluxo. Essa é também a resposta ao método REST que falta: você não envia pelo Bitrix24, envia por fora dele.

O robô Requisição HTTP chama a API do provedor e devolve o código de status e o corpo, de modo que o passo seguinte pode ramificar pelo resultado: 200 significa gravar «enviado» no card, qualquer outra coisa significa abrir uma tarefa para uma pessoa. Monte o payload com Montar JSON em vez de colar chaves na mão, e passe os valores da query string por Codificação de URL — senão o primeiro endereço com um sinal de mais quebra a chamada.

Para as mensagens que você não pode perder, use o Webhook confiável: ele repete em falhas de rede e respostas 5xx com pausas crescentes, em vez de derrubar o processo no primeiro segundo ruim. A diferença só aparece no volume — uma janela de manutenção de cinco minutos no provedor custa a você todas as mensagens daquele intervalo. A mecânica das chamadas nos dois sentidos está em webhooks, e o quadro maior em configuração de robôs no Bitrix24.

Por que os e-mails não chegam?

Portais na nuvem têm um teto diário de e-mails de saída — mil mensagens por dia por padrão. Uma campanha maior que o teto não é cancelada: os primeiros mil saem e o resto espera até amanhã. O teto se mexe: sobe enquanto os destinatários não reclamam e cai quando reclamam, e um volume alto de denúncias de spam pode bloquear o envio de vez. Que fatia dessa cota vai para campanhas e qual sobra para a correspondência do CRM e da caixa é você quem define.

Três consequências práticas. Não coloque o e-mail crítico para a receita — faturas, credenciais, confirmações de pedido — sobre a reputação do portal; mande por um serviço em que o domínio é seu. Limpe a lista antes de enviar, não depois: endereços inválidos geram devoluções, e devoluções puxam o teto para baixo. E mantenha o descadastro realmente em um clique, porque uma denúncia de spam custa mais que um assinante perdido.

O que corrigir na lista antes de enviar

A qualidade da lista decide mais que o texto. Descarte os cards sem endereço com Campo não vazio — eles não vão receber nada de qualquer jeito e só distorcem a estatística. Junte antes os duplicados: três e-mails idênticos para a mesma pessoa é o caminho mais rápido para uma reclamação. O tratamento é resolvido sozinho por Gênero pelo nome, explicado em gênero pelo nome. A higiene geral dos dados está em limpeza do CRM.

Para consertar uma base existente numa passada só, use o lançamento em massa de processos: um modelo — confira o endereço, normalize o telefone, marque a flag — disparado sobre todos os contatos.

O que vem depois

Comece por um único e-mail disparado por evento: acontecimento, condição, envio, e o fato do envio gravado de volta no card. Quando ele sobreviver uma semana sem surpresas, acrescente o SMS ao mesmo cenário — e só então parta para o envio em massa, onde um erro é multiplicado pelo tamanho da sua lista. Os demais blocos estão no catálogo de robôs: condições, chamadas HTTP, ferramentas de texto e datas. E se faltar o que você precisa, descreva a tarefa: a Roboteka constrói as atividades que faltam de graça e as publica na biblioteca comum.