Como notificar novos chamados no Telegram

ATENÇÃO: ESTE DOCUMENTO FOI ATUALIZADO E NO FINAL DELE EXPLICAMOS COMO NOTIFICAR GRUPOS DIFERENTES DO TELEGRAM, DE ACORDO COM A FILA DO CHAMADO.

Em maio de 2021 um membro da comunidade LigeroSmart nos perguntou: É possível notificar um grupo no Telegram quando um chamado é criado?

Aproveitando a ideia, lançamos um pequeno desafio para os participantes da comunidade: Quem conseguiria criar tal notificação utilizando o LigeroEasyConnector!

No vídeo abaixo (cerca de 9 minutos), apresentamos a solução do problema e, logo abaixo, um passo-a-passo para você replicar o feito e começar a receber notificações no seu Telegram:

Passo-a-passo para realizar a integração

1 – Crie um BOT not Telegram (Anote o Token de seu BOT fornecido pelo Bot Father do Telegram

2 – Crie um grupo no Telegram com o BOT que você criou e com as demais pessoas que serão notificadas

3 – Adicione o BOT MyChatInfoBot a este grupo. O que este BOT faz é mostrar o ID do grupo, que será utilizado na integração. Exemplo:

4 – Acesse o LigeroSmart e vá para Administração -> Web Services

5 – Adicione um Web Service, coloque o nome que preferir (utilizarei Telegram no exemplo), adicione um Transporte de Rede como “Requisitante” do tipo LigeroEasyConnector::REST e clique no botão “Salvar”

6 – Ainda na área de “Requisitante”, clique na caixa “Adicionar invoker” e selecione Ligero::LigeroEasyConnector

7 – Coloque o nome que preferir (no exemplo utilizei SendMessage) e adicione um mapeamento de dados de saída da Requisição, selecionando XSLTLigero:

Clique em “Salvar”

8 – Adicione o Disparador “TicketCreate”. Não se esqueça de clicar no + como abaixo (Salve novamente em seguida):

9 – Clique em Configurar no mapeamento XSLTLigero e adicione o código abaixo:

<xsl:stylesheet version="1.0"
 xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
 <xsl:output omit-xml-declaration="yes" indent="yes"/>
    <xsl:template match="RootElement">
    <xsl:copy>
        <chat_id>-560306189</chat_id>
        <parse_mode>Markdown</parse_mode>
        <text>Novo chamado criado:

*<xsl:value-of select="//Ticket/Title" />*

Para visualizar, acesse:
https://meuligero.com/otrs/index.pl?Action=AgentTicketZoom;TicketID=<xsl:value-of select="//Ticket/TicketID" />

        </text>
    </xsl:copy>
    </xsl:template>
</xsl:stylesheet>  

Ficará assim:

(Ajuste a URL para visualizar o chamado conforme necessário)

Clique em Salvar e Finalizar e, quando voltar para a tela do Invoker, clique mais uma vez no Salvar e Finalizar. Você voltará para a tela do Web Service que está sendo criado

10 – Clique no botão Configurar do nosso transporte de Rede como Requisitante:

11 – Ajustes os seguintes parametros:

• Endpoint: https://api.telegram.org
• *Mapeamento do controlador para o invoker ‘SendMessage’: /botXXXXXXXXXXXXXXX/sendMessage
  (Substitua XXXXXXX pelo Token do BOT que você criou)
• Comando válido da requisição para o invoker ‘SendMessage’: POST

Ficará assim:

Salve, Finalize e realize seus testes.

Você pode acompanhar o resultado no Depurador do Web Service:

Notificar grupos diferentes no Telegram de acordo com a fila do Chamado

Uma forma de notificar grupos diferentes, é ajustando o Chat ID de cada grupo no XSLT, de acordo com a fila, utilizando a propriedade xsl:choose.

IMPORTANTE: Você precisa adicionar o BOT que criou em todos os grupos que deseja enviar notificações.

No exemplo abaixo, podemos utilizar o mesmo template de mensagem para notificar dois grupos diferentes no Telegram, de acordo com a fila do chamado (//Ticket/Queue):

<xsl:stylesheet version="1.0"
 xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
 <xsl:output omit-xml-declaration="yes" indent="yes"/>
    <xsl:template match="RootElement">
    <xsl:copy>
        <chat_id><xsl:choose>
            <xsl:when test="//Ticket/Queue='Raw'">-560306189</xsl:when>
            <xsl:when test="//Ticket/Queue='Junk'">-574581430</xsl:when>
            <xsl:otherwise>-574581430</xsl:otherwise>
        </xsl:choose></chat_id>
        <parse_mode>Markdown</parse_mode>
        <text>Novo chamado criado:

*<xsl:value-of select="//Ticket/Title" />*

Para visualizar, acesse:
https://meuligero.com/otrs/index.pl?Action=AgentTicketZoom;TicketID=<xsl:value-of select="//Ticket/TicketID" />

        </text>
    </xsl:copy>
    </xsl:template>
</xsl:stylesheet>

Você também pode enviar textos diferentes de acordo com o fila, ou seja, cada grupo poderá receber um template diferente. Neste caso, o XSLT ficaria assim:

<xsl:stylesheet version="1.0"
 xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
 <xsl:output omit-xml-declaration="yes" indent="yes"/>
    <xsl:template match="RootElement">
    <xsl:copy>
        <xsl:choose>
          <xsl:when test="//Ticket/Queue='Raw'">
             <chat_id>-560306189</chat_id>
             <text>Novo chamado criado:
*<xsl:value-of select="//Ticket/Title" />*
Para visualizar, acesse:
https://meuligero.com/otrs/index.pl?Action=AgentTicketZoom;TicketID=<xsl:value-of select="//Ticket/TicketID" />
            </text>
          </xsl:when>
          <xsl:when test="//Ticket/Queue='Junk'">
             <chat_id>-574581430</chat_id>
             <text>New ticket created:
*<xsl:value-of select="//Ticket/Title" />*
https://meuligero.com/otrs/index.pl?Action=AgentTicketZoom;TicketID=<xsl:value-of select="//Ticket/TicketID" />
            </text>
          </xsl:when>
            <xsl:otherwise>
             <chat_id>-560306189</chat_id>
             <text>Novo chamado criado:
*<xsl:value-of select="//Ticket/Title" />*
Para visualizar, acesse:
https://meuligero.com/otrs/index.pl?Action=AgentTicketZoom;TicketID=<xsl:value-of select="//Ticket/TicketID" />
            </text>
            </xsl:otherwise>
        </xsl:choose>
        <parse_mode>Markdown</parse_mode>

    </xsl:copy>
    </xsl:template>
</xsl:stylesheet>

Restringindo o disparo a apenas algumas filas

Se quiser que a notificação seja disparada apenas quando o chamado for criado em uma ou mais filas específicas, edite o disparador do Invoker, clicando no botão de edição conforme abaixo:

Em seguida, adicione o filtro com o nome da(s) fila(s), conforme a seguir:

Note que escolhemos a opção Regexp para poder definir que a notificação será disparada apenas quando o chamado for criado ou na fila Raw ou na fila Junk.