Canais

Os canais de comunicação representam os meios utilizados pelo Blazon para entregar os alertas gerados na plataforma para agentes externos de comunicação.

Cada canal representa uma rota tecnológica distinta por onde a mensagem pode ser transmitida, como Email, SMS, Syslog, Slack ou Microsoft Teams. Para que possam ser usados no envio de alertas, todos os tipos de canal devem ser previamente configurados no Blazon.

Microsoft Teams

O Microsoft Teams é uma plataforma de comunicação e colaboração desenvolvida e projetada para ambientes de trabalho e equipes. Dentre várias funcionalidades como vídeo conferência e chat em equipe, ela permite a configuração de Webhooks que funcionam como canais de comunicação de assuntos específicos via HTTP.

Na prática, o Microsoft Teams oferece uma maneira segura e simples de se definir uma URL associada a uma conta Microsoft Teams, na qual pode-se enviar mensagens JSON por meio do protocolo HTTP.

Integração com o Microsoft Teams

Para integração de um canal Microsoft Teams ao Blazon, é necessário antes configurar um Incoming Webhook no Microsoft Teams e posteriormente adicioná-lo ao Blazon. Os passos necessárioas para isso são:

1

Criação do Incoming Webhook no Microsoft Teams

Esse passo deve ser feito diretamente no Microsoft Teams usando uma das duas opções abaixo:

Opção mais simples mas que não será mais disponibilizada em breve (está em fase de depreciação):

Create an Incoming Webhook - TeamsMicrosoftLearn

Opção recomendada atualmente:

Create incoming webhooks with Workflows for Microsoft Teams - Microsoft Supportsupport.microsoft.com

Nota

A utilização dos Webhooks por meio de Workflows pode requerer um tipo de licença específica no Microsoft Teams.

2

Criação do Webhook no Blazon

Após configurar seu Incoming Webhook no Microsoft Teams, você deve adicioná-lo ao Blazon. O link abaixo descreve os passos necessários para essa configuração.

https://docs.blazon.im/adminconsole/alertas/canais-de-notificacao/microsoft-teams#criando-um-webhook-microsoft-teamsdocs.blazon.im

Slack

O Slack é outra plataforma de comunicação e colaboração que reúne conversas, ferramentas e arquivos, facilitando a comunicação e o trabalho em equipe.

De forma similar, o Slack oferece uma maneira simples de definir uma URL associada a uma conta Slack, na qual pode-se enviar mensagens usando o protocolo HTTP e geralmente algum formato como JSON.

Integração com o Slack

Para integração de um canal Slack ao Blazon, é necessário antes configurar um Incoming Webhook no Slack e posteriormente adicioná-lo ao Blazon, semelhante ao que é feito para o Microsoft Teams. Os passos são:

1

Criação do Incoming Webhookno Slack

Esse passo deve ser feito diretamente no Slack usando sua documentação oficial:

Sending messages using incoming webhooks | Slack Developer Docsapi.slack.com

2

Criação do Webhook no Blazon

Depois de configurar seu Incoming Webhook no Slack, é necessário adicioná-lo ao Blazon. O link abaixo detalha os passos para realizar essa configuração.

https://docs.blazon.im/adminconsole/alertas/canais-de-notificacao/slack#criando-um-webhook-slackdocs.blazon.im

Syslog

O Syslog é um protocolo padrão utilizado para o envio de mensagens de log em redes IP. Ele permite que dispositivos como servidores, roteadores, firewalls e aplicações enviem mensagens de eventos (logs) para um servidor central de registros, conhecido como servidor Syslog.

As mensagens Syslog trafegam sobre protocolo TCP, TCP+TLS ou UDP.

Integração com o servidor Syslog

Para integração de um canal Syslog ao Blazon, é necessário antes configurar um servidor Syslog e posteriormente configurar no Blazon. Os passos são:

1

Configuração de um servidor Syslog

Existem diversos servidores Syslog disponíveis, e você pode usar qualquer um de sua preferência. Recomendamos alguns links:

rsyslog 8 daily stable documentationwww.rsyslog.com

RFC 5424: The Syslog ProtocolIETF Datatracker

2

Criação do endpoint no Blazon

Assim como nas configurações para Slack e Microsoft Teams, é preciso configurar um endpoint Syslog no Blazon. Essa configuração deve ser realizada no Admin Console, conforme detalhado no link abaixo.

https://docs.blazon.im/adminconsole/plataforma/syslog#criando-um-endpoint-syslogdocs.blazon.im

Email

Para o envio dos alertas via Email, você deverá garantir que há uma configuração SMTP ativa no Blazon.

Integração com o servidor de Email

A integração para envio de alertas por e-mail é simples e consiste apenas na configuração do servidor SMTP que o Blazon utilizará para o envio das mensagens. O processo está detalhado no Guia do Admin Console:

https://docs.blazon.im/adminconsole/plataforma/servidor-de-smtpdocs.blazon.im

SMS

Para o envio dos alertas via SMS, você deve configurar um endpoint SMS.

Integração com provedores de SMS

A integração de alertas via SMS requer a configuração de ao menos um provedor de SMS para o envio das mensagens. O processo está detalhado no Guia do Admin Console:

https://docs.blazon.im/adminconsole/plataforma/sms#configurando-um-provedor-smsdocs.blazon.im