A Eventiza tem API ou webhooks para integrar com o meu sistema?
Sim. A Eventiza tem uma API para conectar os seus sistemas aos seus eventos e webhooks que avisam o seu sistema automaticamente quando algo acontece, como uma nova compra.
Com eles, você pode, por exemplo:
- levar compradores e participantes para o seu CRM ou ERP;
- usar o seu próprio controle de acesso, fazendo o check-in pelo seu sistema;
- disparar automações de e-mail ou WhatsApp quando uma compra é confirmada;
- acompanhar vendas em ferramentas de BI e planilhas.
O que a API permite
Com a API, o seu sistema consegue, nos eventos da sua conta:
- consultar os seus eventos e os dados de cada um;
- listar os participantes e consultar um participante específico;
- atualizar os dados de um participante;
- fazer o check-in de um participante;
- consultar os pedidos do evento ou um pedido específico;
- criar, consultar e apagar cupons de desconto.
O que os webhooks avisam
Os webhooks enviam um aviso para uma URL do seu sistema sempre que acontece um destes gatilhos:
- Novas compras e atualização em estado de compras: por exemplo, um pedido criado, pago ou cancelado;
- Alteração de dados de participantes: mudanças nas respostas do formulário de inscrição;
- Novos carrinhos abandonados: compras iniciadas e não finalizadas.
Assim, o seu sistema não precisa ficar consultando a API para saber se algo mudou.
Como pedir o acesso
O acesso à API é liberado pela nossa equipe. Para pedir a liberação para a sua conta, fale com a gente pelo formulário eventiza.com.br/fale-conosco, informando o e-mail da sua conta e o que você pretende integrar.
Depois que o acesso for liberado
A configuração fica em Configurações da conta > Integrações e APIs (clique na sua foto, no canto superior direito).
Gerar a chave de API
- Em Chave de API, clique em Gerar nova chave e depois em Gerar token.
- Copie o token e guarde em um local seguro: ele não é exibido de novo.
Ao gerar um novo token, os anteriores deixam de funcionar. Quem tem o token consegue acessar e alterar as informações dos seus eventos, então não compartilhe com ninguém além de quem vai fazer a integração. Na mesma tela você acompanha as Chamadas totais à API e as chamadas do mês.
Configurar os webhooks
- Em Envio de Webhooks / Gatilhos, informe a URL que vai receber os avisos.
- Marque os gatilhos que deseja receber.
- Clique em Salvar. Use Enviar evento teste para conferir se a sua URL está recebendo.
- Opcional: no ícone de engrenagem, informe uma Chave de API. Ela é enviada em todos os webhooks, para o seu servidor confirmar que o aviso veio da Eventiza.
Para quem vai desenvolver
- Envie o token em todas as chamadas, no header X-EVENTIZA-TOKEN.
- A chave opcional dos webhooks chega no header x-api-key.
Caso encontre qualquer problema ou apenas queira tirar dúvidas, entre em contato conosco.