Usando a integração do Chat

A integração personalizada está disponível no Chat, permitindo configurar webhooks de entrada e saída.

Webhooks de entrada

Um webhook de entrada publica mensagens de fontes externas no Chat. Ele aproveita solicitações HTTP gerais com uma carga JSON, juntamente com outras configurações opcionais.

Para enviar mensagens:

Há duas formas de enviar dados para a URL do webhook:

A carga JSON pode incluir uma propriedade text, que será publicada no canal atribuído. Por exemplo:

payload={"text": "First line of message to post in the channel.\nAlso you can have a second line of message."}

Para adicionar links:

Para adicionar um link, você pode inserir o link diretamente no text. Por exemplo:

payload={"text": "<https://www.synology.com>"}

Outro exemplo:

payload={"text": "Check this!! <https://www.synology.com|Click here> for details!"}

Para carregar arquivos:

Você também pode carregar um arquivo em suas postagens de entrada. Para carregar um arquivo, sua carga JSON deve conter uma propriedade file_url e também uma propriedade de texto opcional. Baixaremos sua URL e a trataremos como uma postagem de carregamento de arquivo do usuário. Por exemplo:

payload={"text": "a fun image", "file_url": "http://imgur.com/xxxxx"}

Nota:

Webhooks de saída

Os webhooks de saída ouvem palavras de ativação nas mensagens do Chat. Essas palavras de ativação enviam dados relevantes para uma URL externa. Os webhooks de saída só podem ser ativados quando uma ou as duas condições abaixo são atendidas:

Se um canal for indicado, as palavras de ativação são opcionais. As palavras de ativação são necessárias quando nenhum canal é selecionado. No entanto, se duas condições forem definidas, o webhook de saída só ocorrerá quando duas condições forem atendidas ao mesmo tempo.

Dados de saída:

Quando uma mensagem recebida corresponde a um gatilho, um POST será entregue à URL atribuída. Campos de dados são descritos abaixo:

token: bot token
channel_id
channel_name
user_id
username
post_id
timestamp
text
trigger_word: which trigger word is matched

Resposta:

Se o destino externo quiser responder no canal do Chat, o JSON precisará ser retornado no corpo da resposta. Os campos suportados são os mesmos do JSON de um webhook de entrada.