GitHub Informer for Zoho Cliq

GitHub Informer for Zoho Cliq

As a developer, you know how important it is to stay up-to-date with changes made to your code repository. But constantly checking for updates can be a time-consuming process. That's where GitHub Informer comes in!

Available Regions:

US, IN, EU, AU, JP

GitHub Informer is a new integration for Zoho Cliq that makes it easy to notify any changes in a GitHub repository directly in a channel without having to install an extension. This is all made possible through the use of GitHub Actions.

Here's how to set it up:
  1. In GitHub, in your required code repository, create a new .yml file with the path .github/workflows/<name_of_the_file>. 
    Ex:  github/workflows/CliqGitHub.yml
  2. Go to this repository, and navigate to the CliqConnector.yml file. Copy the entire code in the file and paste it in the file you created in your repository (ex: CliqGitHub).
  3. Now you will have to configure your channel endpoint secret so the updates are sent to your required channel. For this, you will need your channel endpoint along with a webhook token from Cliq.
  4. Webhook token:
    a)     To create a webhook token in Cliq, click on your profile picture on the top right on the Cliq home page, and navigate to Bots & Tools -> Webhook Tokens.
    b) Click on Generate new token and copy it.
  5. Channel endpoint:
    a)      To get the channel endpoint, go to the required Cliq channel in which you want updates, and click on the channel image for the channel info.
    b)      Navigate to the Connectors tab and copy the channel's API endpoint.
  6. Now, to configure the GitHub action, go to your required GitHub repository, go to Settings -> Secrets and Variables -> Actions.
  7. Click on the New repository secret button.
  8. For the name, enter "ENDPOINT". you need your channel endpoint along with a webhook token from Cliq.
  9. For the secret, enter your channel endpoint along with a webhook token from Cliq in this order: Channel endpoint + "?zapikey=" + webhook token. For example: https://cliq.zoho.com/company/6423401/api/v2/channelsbyname/GitHubupdates/message?zapikey=1001.f12fxxxxxx

  10. Click on Add secret to configure your endpoint.
  11. Click on the Commit button to commit the file. Now GitHub will automatically communicate with Cliq and create the link (the process might take up to a minute).
  12. Now any changes or updates made in your repository will be informed in the Cliq channel.

Changing the message updates in the channel:

The GitHub Informer integration for Zoho Cliq provides  different message formats for specific actions in a GitHub repository. However, you can customize these messages to suit your needs.

To edit the message format for a specific action, you need to edit the code in the CliqConnector.yml file. Here's how you can do it:
  1. Open the CliqConnector.yml file in GitHub.
  2. In the code, you will find a list of specific actions such as "push", "pull_request", "create-message", and so on.
  3. To edit the message format for a specific action, find the code line that corresponds to that action and uncomment it by removing the "#" symbol from the beginning of the line.

  4. Edit the message format to suit your needs. You can use placeholders such as "(event)", (repo)", and "(action)" to dynamically insert information into the message.
  5. Save your changes to the CliqConnector.yml file and commit the changes to your GitHub repository.

Conclusion

With GitHub Informer, you can save time and stay informed about changes to your code repository without having to constantly check for updates. It's a great tool for teams who want to stay up-to-date with changes made to their codebase in real-time.

So if you're a developer who uses GitHub and Zoho Cliq, be sure to check out GitHub Informer. It's the perfect integration to keep your team informed about changes to your codebase.