Crie uma subscrição de eventos para receber um aviso por email ou webhook quando algo acontecer na sua plataforma de e-mail marketing. Por exemplo, quando alguém se inscreve ou se descadastra da sua newsletter, ou quando muda o status de um SMS.
Criar uma subscrição de eventos
Para configurar as notificações, siga estas etapas:
- No menu, clique em Configurações > Notificações de eventos.
- Clique em Adicionar.

- Em Nome, digite um nome para identificar a subscrição.

- Em Tipos de evento, marque as ações que acionam o envio de dados. Você pode marcar várias:
- Evento de inscrição: notifica quando um usuário se inscreve.
- Evento de descadastro: notifica quando um usuário cancela sua inscrição.
- SMS enviado: notifica quando um SMS é enviado.
- SMS entregue: notifica quando o SMS é entregue.
- SMS falhou: notifica se o SMS falhar.
- SMS expirado: notifica se o SMS expirar.
- SMS clicado: notifica se o SMS for clicado.
- Evento de reinscrição por SMS: notifica se um usuário se reinscrever.
- Evento de descadastro SMS: notifica se um usuário cancelou a inscrição via SMS.
- Em Método de entrega, escolha como quer receber as notificações:
- Email: digite o endereço de email em que quer recebê-las.

- Webhook: digite a URL. Opcional: para adicionar cabeçalhos e seus valores, clique em Adicionar cabeçalho.

- Email: digite o endereço de email em que quer recebê-las.
- Deixe marcada a caixa Habilitado, que já aparece marcada. Se você desmarcá-la, a subscrição é salva desabilitada e você pode usá-la no futuro sem excluí-la.
- Clique em Criar Subscrição de eventos.
Testar um webhook
Antes de criar a subscrição, você pode verificar se o seu servidor recebe as notificações:
- Ao lado do campo URL, clique em Enviar teste e escolha o tipo de evento que quer testar.
- Na janela Você tem certeza?, clique em Sim. A Mailrelay envia uma solicitação com dados de teste para a URL.
Se o seu servidor não aceitar a solicitação, você verá o aviso "Falha de Webhook" com o código http que ele retornou.
Gerenciar suas subscrições de eventos
Em Configurações > Notificações de eventos você verá a lista das suas subscrições. Para encontrar uma, use os filtros ID, Nome ou Método de entrega e clique em Buscar.
Em cada linha você tem estes botões:
- Exibir: você vê todos os dados da subscrição, inclusive quando foi criada (Criado em) e quando foi atualizada (Atualizado em).
- Editar: você altera os dados, por exemplo para desmarcar Habilitado e pausá-la sem excluí-la.
- Deletar: você exclui a subscrição.
Em Exibir, a aba Registro mostra as alterações feitas na subscrição: quando, qual usuário, de qual IP e qual ação. Se várias pessoas da sua empresa têm o seu próprio usuário na conta, assim você sabe quem criou ou alterou cada subscrição.
Gerenciar as subscrições com a API
Você também pode criar, consultar, alterar e excluir as subscrições de eventos com a API da Mailrelay. Para usá-la, você precisa de uma chave API. Veja como fazer isso na seção Event Subscriptions da documentação da API.
Se você envia SMS com a API, consulte também SMS usando nossa API e Mensagens SMS enviados por API.
Perguntas frequentes
Estas são as dúvidas mais comuns sobre a subscrição de eventos.
Posso escolher vários tipos de evento na mesma subscrição?
Sim. Por exemplo, marque Evento de inscrição e Evento de descadastro para saber quando alguém se inscreve ou se descadastra da sua newsletter.
Qual é a diferença entre Email e Webhook?
Com Email, você recebe as notificações no endereço de email que indicar. Com Webhook, os dados são enviados para a URL que você indicar, e você pode adicionar cabeçalhos.
Posso pausar uma subscrição sem excluí-la?
Sim. Edite-a e desmarque a caixa Habilitado. Na lista, a coluna Habilitado mostrará "Não".
Está disponível na conta gratuita?
Sim. Você pode criar subscrições de eventos com a conta gratuita. É a mesma conta com a qual você faz suas campanhas de e-mail marketing e o envio em massa de e-mails.