Manter os contatos sincronizados com a API
Envie usuários, eventos e desinscrições a partir do seu servidor, para que as pessoas certas recebam os e-mails certos.
O widget informa o UserSignal sobre as pessoas enquanto elas usam seu produto. A Management API cobre todo o resto, a partir do seu próprio servidor: pessoas que se inscrevem no app móvel, pessoas que deixam de visitar, coisas que acontecem em segundo plano e desinscrições.
Crie um token em Settings › API. A mesma página tem o guia completo com exemplos.
Contacts
- Crie ou atualize um contato, ou até 100 de cada vez, com e-mail, nome, idioma, país, tags e quaisquer propriedades.
- Use seu próprio ID de usuário, para que o contato corresponda à pessoa no seu app e no widget.
- Defina
subscribedpara indicar se concordaram em receber e-mails de marketing. - Exclua um contato quando a conta for encerrada.
Um endereço enviado pela API é considerado confirmado por você, então o contato pode receber e-mails.
Events
Registre o que a pessoa fez, como signed_up, first_payment ou cancelled. Eventos iniciam automações e podem ser usados em segmentos. Um evento pode incluir o horário em que ocorreu; um com mais de 24 horas é armazenado, mas não dispara nada.
People who must not be emailed
- Envie os endereços que se desinscreveram, que tiveram retorno (bounce) ou que registraram reclamação na ferramenta de e-mail que você usou antes, para que seus primeiros envios daqui não os alcancem.
- Leia quem se desinscreveu, reclamou ou teve retorno (bounce) aqui, para manter seus registros atualizados.
Campaigns you sent before
Se você está migrando de outra ferramenta de e-mail, pode importar as campanhas que já enviou, com quem abriu e clicou, para que seu histórico fique em um só lugar. Elas são marcadas "Another tool" e não contam para sua reputação de envio aqui.
Do I need the API?
Não para começar. Com o widget e a verificação de identidade, as pessoas que usam seu app web já são contatos para os quais você pode enviar e-mails. Adicione a API quando precisar dos casos acima.
Atualizado a 12 de outubro de 2026