Existe um tipo de mensagem que não deveria depender de ninguém digitar: confirmação de agendamento, aviso de cobrança, código de acesso, status de pedido, lembrete de retorno. É informação que já está no seu sistema e precisa chegar ao cliente no momento certo.
É para isso que serve o disparo transacional por API.
Como funciona, sem enrolação
Seu sistema faz uma chamada HTTP autenticada informando canal, destinatário, o modelo de mensagem e as variáveis. A plataforma cuida do resto: formata, respeita as regras do canal, envia, registra e devolve o evento de entrega.
Do lado do seu sistema é uma requisição. Do lado do cliente, é uma mensagem que chega no canal que ele lê.
O que separa uma integração boa de uma bagunça
- Idempotência. Envie um identificador único por evento. Se a chamada repetir por falha de rede, o cliente não recebe a mesma mensagem duas vezes.
- Fila com retentativa. Falha acontece. O reenvio precisa ser automático e com limite.
- Registro auditável. Quem enviou, para quem, com qual conteúdo e quando. Sem isso, discussão com cliente vira palavra contra palavra.
- Separação por ambiente. Token de teste e token de produção diferentes. Parece óbvio; é o erro mais comum.
Cuidados que protegem o número
Disparo transacional é o uso mais bem aceito do canal, mas ainda existe limite:
- Use modelo aprovado para mensagem ativa; texto livre fora da janela é bloqueado.
- Respeite opt-out. Cliente que pediu para não receber precisa sair da régua na hora.
- Evite madrugada. Fora de emergência, agende para horário civilizado.
- Não use canal transacional para promoção disfarçada. É o caminho mais rápido para reclamação e queda de qualidade do número.
O outro lado: a resposta
A parte esquecida do projeto é o que acontece quando o cliente responde “não vou poder ir”. Se essa resposta cai no vazio, a automação piorou a experiência.
O desenho certo devolve a resposta para dois lugares ao mesmo tempo: a fila de atendimento humano e o seu sistema, por webhook. Assim a recepção vê e a agenda é atualizada.
Por onde começar
Escolha um caso, o mais repetitivo: confirmação de agendamento costuma ser o melhor primeiro passo. Meça por duas semanas, entrega, resposta e impacto na falta. Depois adicione cobrança e pós-atendimento.
Integração boa é construída caso a caso, não em um projeto de seis meses. O modelo de chamada e os eventos estão na página de integrações.