Notificações

O sistema de mensagens de eventos foi criado como substituto do sistema obsoleto de notificação de status de entrega de SMS de saída e entrada (esses sistemas são considerados obsoletos, não serão melhorados e não são recomendados para uso).

O sistema de mensagens de eventos permite que você envie informações sobre eventos específicos para URIs especificadas (http ou email). Você pode personalizar o sistema para enviar notificações de um evento para diferentes URIs.

Para configurar as notificações, abra a página de configurações (account.lox24.eu -> Configurações -> Notificações), clique em “Criar um novo webhook” e insira no campo URI o endereço http ou e-mail para o qual você deseja receber notificações. Por padrão, todos os eventos possíveis serão enviados para a URI especificada. Se você quiser ser notificado apenas sobre certos eventos, marque a caixa ao lado dos eventos sobre os quais deseja ser notificado.

Se forem necessárias notificações adicionais, repita as instruções acima. Um máximo de cinco configurações individuais de notificação podem ser criadas.

As informações do evento serão notificadas no formato de objeto JSON, que tem o mesmo formato para todos os eventos e difere apenas nos dados do próprio evento.

Estrutura do objeto de evento

Campo	Tipo	Descrição
id	string (36 chars)	ID do evento
api_version	string	Versão da estrutura de dados
name	string	Nome do evento, ex. ‘sms.delivery’
created_at	integer	Timestamp unix quando o evento foi criado
attempt_total	integer	Número total de tentativas (re-tentativas)
attempt_number	integer	Número atual da tentativa
data	object	Dados do evento (veja lista de eventos)
notification_task_id	string (36 chars)	ID da tarefa de notificação (identificador da solicitação)

Exemplo de evento

{
  "id": "a3cd6e19-8af2-498d-ad07-c7840f1b4ac8",
  "data": {
  "id": "d6c12ac4-cc7d-11ec-b6da-525400bbb7dc",
  "key_id": 8207,
  "dlr_code": 1,
  "status_code": 100,
  "callback_data": "some data from user's request here"
  },
  "name": "sms.delivery",
  "created_at": 1653378603,
  "api_version": "2022-05-25",
  "attempt_number": 1,
  "attempts_total": 4,
  "notification_task_id": "3378de83-de66-4de8-9d29-2b10d41bb641"
}

Tipos de transporte de eventos

O sistema de notificação pode enviar informações de eventos de duas maneiras (transportes): HTTP e E-mail.

HTTP

O json é enviado como o corpo da requisição http com o cabeçalho Content-Type: application/json. O serviço continuará tentando enviar a requisição (em intervalos de tempo crescentes) até que receba uma resposta com um código de status >= 200 e < 300 ou o número de tentativas atinja o valor especificado no campo attempt_number.

NOTA: A resposta do seu script de endpoint não é levada em consideração, portanto, você deve monitorar seu script. Em caso de mau funcionamento, não há notificação por nossa parte.

E-mail

O json é enviado como o corpo do e-mail com uma única tentativa de um e-mail no-reply@lox24.eu.

Hosts de serviço e endereços IP

Os alertas são enviados dos seguintes endereços IP. Se você usar um firewall, não se esqueça de colocar esses endereços IP na lista de permissões.

IPv4:

162.55.80.140
162.55.80.141
5.9.114.27
144.76.190.20

IPv6:

2a01:4f8:271:10a7::2
2a01:4f8:271:10a6::2

Notificações

Notificações

Estrutura do objeto de evento

Exemplo de evento

Tipos de transporte de eventos

HTTP

E-mail

Hosts de serviço e endereços IP

Lista de eventos