Eventos da API

Onde encontro os eventos da API?

Acesse nossa documentação da API e, no canto inferior esquerdo, clique em Eventos API:

Em seguida, vão ser abertos todos os eventos da API:

Onde acho o payload dos eventos?

Após abrir todos os eventos, clique naquele que deseja:

Agora, no canto direito da tela, é possível ver o Payload do evento:

Como utilizo o payload de cada evento?

O payload são os campos que o evento precisa. Como exemplo, vou utilizar o payload de pedido pago. Confira:

Esse payload tem o campo customer e, dentro dele, existem vários campos então vai ficar assim:

• customer[first_name];
• customer[last_name];
• customer[phone];
• customer[email];
• order[id];
• order[products_total];
• order[total];
• order[discount];
• order[products][0][name];
• order[products][0][quantity];
• order[products][0][value];
• order[delivery][fee];
• order[delivery][description].

O campo order[producsts][0] possui o [0] porque é um array. A regra segue para qualquer payload com array, como você vê abaixo:

Agora, o order[delivery] é um objeto:

Onde encontro a URL de um evento?

Após escolher o evento que deseja, no canto superior direito da tela você vai encontrar a URL do evento:

Você pode verificar o tipo do evento, como mostra a imagem:

Agora, clique nessa URL para conseguir copiar-lá:

Como achar o ID da integração para colocar na URL?

Na URL do evento, existe um campo assim {integrationId}. Nele, vamos colocar o número da sua integração. Para isso, siga os passos abaixo.

Acesse a sua integração da API no Notificações Inteligentes e procure o campo Como fazer a integração:

Na URL, você consegue encontrar o número da sua integração:

Agora, vamos colocar esse número na URL do evento como no exemplo a seguir:

Essa é a URL do evento de pedido pago: https://api.notificacoesinteligentes.com/integrations/{integrationId}/events/order-paid.

No campo {integrationId}, vamos trocar o dado pelo número da sua integração. Então, vai ficar assim: https://api.notificacoesinteligentes.com/integrations/493/events/order-paid.

Onde ficam os Headers?

Após escolher o evento que deseja, você pode encontrar os Headers:

Como identifico a autorização do evento?

Após escolher o evento, você pode encontrar o tipo de autorização do evento. Aqui é utilizado o tipo Bearer:

Para saber qual a sua token, acesse sua conta do Notificações Inteligentes e no canto superior direito, clique no seu nome:

Agora, clique em Configurações:

Procure o campo Chave de API:

Caso você não tenha uma chave da API, clique em Gerar nova chave:

Pronto! Essa é sua token.

Sempre que quiser saber qual a chave de autorização do evento, utilize o tipo + token:

• Bearer d1r2a3g4o5n6b7a8l9l0z.

Atualizado em: 27/07/2023