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

  1. Em Chave de API, clique em Gerar nova chave e depois em Gerar token.
  2. 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

  1. Em Envio de Webhooks / Gatilhos, informe a URL que vai receber os avisos.
  2. Marque os gatilhos que deseja receber.
  3. Clique em Salvar. Use Enviar evento teste para conferir se a sua URL está recebendo.
  4. 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.

Compartilhar