Bigin Variables | Using Bigin Variables and widgets to build an AI-assisted email composer

Bigin Variables | Using Bigin Variables and widgets to build an AI-assisted email composer

Hello Biginners!

In our previous post, we explored how to embed custom UI components inside Bigin using widgets. Building on that, this post looks at Bigin Variables and how they work together with widgets to build a topping that is easy to configure and maintain. To show this in action, we will walk through a real use case for a topping called Bigin With GLM, an AI-powered follow-up email composer built into the Contacts module of Bigin.

What are Bigin Variables?

Bigin Variables are org-level values stored in your Bigin account. They are not tied to any record or module. They belong to the topping and can be read or updated by your code at any time. 

You can think of them as a settings layer for your topping. Instead of hard-coding values directly into your code, you store them as separate variables for which values can be dynamically provided by the end user during topping installation. Once the topping is published, admins can access and manage these values directly from their Bigin account based on the permissions you set, without any involvement from the developer.

To create a variable, go to Custom Properties in the left panel of the Developer Console and click Create your first Bigin variable.


Fill in the Variable Name and choose a Variable Type based on the kind of value the variable will hold, such as Single Line for short text values like a model name. Next, set the Permission to control who can see and change the value. A Read/Write variable is visible to the end user and can be updated by them at any time. A Read Only variable is visible but cannot be changed. A Hidden variable is hidden from the UI and is only accessible through code. Once you have filled in all the details, click Save.

Notes
Note: The Developer Console will add your topping namespace as a prefix to the API name automatically. Always use the full prefixed API name to access the variable in your Deluge code.
Now that we know what Bigin Variables are, let us see how they are used in a real topping.

The use case: Bigin With GLM

Sales reps spend a lot of time writing follow-up emails after calls and meetings. Writing a good, personalized email for every contact takes time, especially when managing many deals at once.

Bigin With GLM solves this by adding an AI email composer directly into the Contacts module. When a rep opens a contact record and clicks the Send AI Mail button, a widget opens. The widget reads the contact's details, such as their name, job title, company, industry, open deals, recent activities, and notes, and uses that information to generate a personalized follow-up email using the GLM AI model. The rep can review and edit the email, then send it from within Bigin. The sent email is saved as a note on the contact record automatically.

This topping uses four components from the Bigin Developer Console: Connections, Bigin Variables, widgets, and Deluge REST API functions. Let's put these components together and build the topping.

Setting up the topping

To build and test Bigin With GLM, follow these steps in order.

Start by creating the two Connections in the Bigin Developer Console. BiginWithGLM is a default Bigin service connection with the OAuth scopes ZohoBigin.modules.ALL, ZohoBigin.settings.variables.READ, and ZohoBigin.send_mail.all.CREATE. GLM Connection is a custom service connection using API Key authentication for the GLM API at https://api.z.ai. For step-by-step instructions on creating these connections, refer to our earlier posts on setting up default service connections and setting up custom service connections in this series.


Next, let's create a Bigin Variable that will be used to get the AI model name from the end user. AI providers update and deprecate their models regularly, and hard-coding the model name in the Deluge function would mean a developer has to update the code and republish the topping every time that happens. By storing it as a Read/Write variable instead, an admin can update the model name directly from their Bigin account the moment a newer model is available, and the topping will start using it right away, with no code changes and no republishing needed. This is how Bigin Variables are of real value. To do this, go to Custom Properties and create the AI Model name variable. Set the Variable Name to AI Model name, the Variable Type to Single Line, the Permission to Read/Write, and leave the value field empty. Then click Save.


NotesNote: The Value field is left empty here because the model name will be prompted during the topping installation. When an admin installs the topping, they will be asked to enter the model name, and it will be saved as the variable value automatically.
After that, set up the widget. If you have not read our previous post on widgets, we recommend going through it first: using widgets to extend the Bigin UI.

Go to Connected Apps and create a new Connected App with Internal Hosting. Build your ZET project locally, add the BiginWithGLM.zip file from the attachment, and upload the packaged ZIP.


Then go to Components and select the Links & Buttons tab. Click Create Your Button. Set the module to Contacts, name the button Send AI Mail, and set the placement to View Page. For the action, select Invoke a Widget. In the Sandbox URL, provide the path to your widget file.

The Production URL will be populated automatically from your Connected App once the zip file is uploaded. The Dimension is set to 700 x 700 px by default. Click Save.


When the Send AI button is clicked, the widget opens and calls the Deluge functions (which will be discussed be in next section) in the background to fetch the contact's details and generate a personalized email draft.

The widget is built as a simple HTML file that loads inside Bigin using the Bigin Widget SDK. It has three fields: a To field that is pre-filled with the contact's email address from the PageLoad event, a Subject field, and a Body field that the rep can edit. There are two buttons: Generate Draft and Send Email.

The rep can review the draft, make any edits, and send it directly to the contact's email address from within Bigin. Let's look at how these Deluge functions make that happen.

The Deluge functions

Bigin with GLM uses two Bigin REST API Functions, both called by the widget using ZOHO.BIGIN.FUNCTIONS.execute(). The first function generates the email draft, and the second function sends it. The full code for both functions is available in the attachment.

The first function, generate_followup_draft, is the main function of the topping. It reads the AI model name from the biginai__AI_Model_name variable, then fetches the Contact record, the linked Company record, open Deals, Activities, and Notes. After gathering all the data, the function builds a prompt, calls the GLM API using the GLM Connection with the model name from the variable, and returns the draft to the widget.

The second function, send_followup_mail, sends the email and saves it as a note on the Contact record. After sending, it saves the email as a note titled Follow-up Email Sent.

With both functions in place, the topping is ready to be published. For detailed instructions on how to test and publish your topping, refer to our post on testing and publishing Bigin toppings in this series.

What happens when the topping is installed

Once the topping is published, you can test it by creating a Contact record in Bigin with relevant details such as the contact's name, job title, company, and email address. Adding a description about the contact's background and a note about your recent interaction with them will help the AI generate a more personalized and contextual email draft.

Once the contact record is ready, open the Contact record and click the Send AI Mail button. The widget will open and generate a personalized email draft based on the contact's details. Review the draft, make any edits, and click Send. The email will be sent from your account and saved as a note on the contact record automatically.

For a detailed walkthrough of the topping in action, watch our screen recording.


In this post, we built Bigin with GLM, an AI-powered topping, and used it to show how Bigin Variables and widgets work together in a real topping. Bigin Variables gave us a settings layer to store the AI model name so admins can update it without touching the code, and the Widget brought the experience directly into the Contacts module so reps can generate and personalized emails without leaving Bigin.

Combined with the Connections, Deluge Functions, and other components we have covered in our previous posts, you now have a complete picture of how a production-ready topping is built. We will continue exploring more components of the Bigin Developer Console in our next posts.

Stay tuned!

Attachments

<< Previous                                                                                                                                                                                   Next>>                                                                                                                                                                                                 




    • Recent Topics

    • KB Articles from Zoho Learn - Import as .md

      I love the concept of being able to use articles from Zoho Learn as knowledge base articles for Zia Agents. This will absolutely help with proper documentation and organization of company processes and SOPs. This was a great concept. However, even when
    • Why don't Zia agents support file uploads?

      I am trying to build a Zia Agent that allows uploading of a PDF file and uses the GLM5 model to process it and extract information. But agents.zoho.com has no way to enable file uploads on the agent. Additionally, GLM5 based agents keep outputting their
    • Building Toppings #10 - Using signals to build real-time notifications between Bigin and Zoho Desk

      Hello Biginners! In our previous post, we covered Bigin Variables and Widgets. In this post, we'll explore another component: Signals. To show how Signals work, we will build a real-time use case integrating Bigin and Zoho Desk. It connects Zoho Desk
    • Cliq iOS can't see shared screen

      Hello, I had this morning a video call with a colleague. She is using Cliq Desktop MacOS and wanted to share her screen with me. I'm on iPad. I noticed, while she shared her screen, I could only see her video, but not the shared screen... Does Cliq iOS is able to display shared screen, or is it somewhere else to be found ? Regards
    • ¡Gracias por acompañarnos en los Workshops de Zoho España!

      Los pasados 3 y 4 de noviembre celebramos una nueva edición de los Workshops de Zoho España en el Hotel NH Las Ventas de Madrid. Dos jornadas de formación práctica, demostraciones en directo y encuentros con expertos de Zoho en las que compartimos conocimientos,
    • Feature Request: Fully customizable record layouts in Zoho FSM (movable sections and custom subform tables)

      Hi Zoho FSM Team and Community, We’d like to suggest a feature that we think would help many FSM users: full control over the layout of record detail pages, starting with the Work Order view. Current situation When you open a Work Order, its sections
    • Mass Update Option for Changing Work Order Owner

      Hello FSM Team/Mr. Abid, We would like to inquire if there is an option to mass update or bulk change the Owner of Work Orders in Zoho FSM. Current Situation: At the moment, the Owner of a Work Order can only be changed individually, which becomes time-consuming
    • Never miss a follow-up with personal reminder agent | Zoho Cliq AI Use Case #03

      A task mentioned mid-conversation rarely survives the conversation. Someone asks you to follow up, you say you will, and by the time you remember, the message is three hundred lines back, buried under two meetings and a dozen other threads. Personal Task
    • Calendar won't load

      I run into this problem about once a week, where I try to open my Zoho calendar in a web browser, and it just gets stuck, waiting forever to load (see attached screenshot). I'm usually using Edge or Duck-Duck-Go browser. Sometimes it loads just fine,
    • Change 'default' project dashboard

      Is it possible to change the default project dashboard for all projects? Both in layout and in what widgets are shown? We have a lot of (short-running) projects and I want to quickly see the tasks and milestones when I open a Project, but I don't want to change the layout for all my projects manually. Thanks, Menno
    • Multiple subscription plan line items in Zoho Billing quotes

      I run an IT company and sell a lot of licences. A client might have multiple subscription plans including software licences in different categories. A client might have Microsoft licences, antivirus licences, web hosting and maintenance package services.
    • [ZohoDesk] Improve Status View with a new editeble kanban view

      A kanban view with more information about the ticket and the contact who created the ticket would be valueble. I would like to edit the fields with the ones i like to see at one glance. Like in CRM where you can edit the canvas view, i would like to edit
    • Live connection to DS files in Zoho Creator / ChatGPT

      As an idea, we are using ChatGPT to build with Zoho Creator (outside of Zia), which is works brilliantly to assist write deluge, provide test suggesitons etc. Currently we are uploading the DS files which are very point in time, it would be great to have
    • Unable to integrate Whatsapp Messaging into Zoho CRM - Business Messaging

      Hello, I want to set up Business Messaging in our Zoho CRM and am struggling to set it up. I have logged into the account and our facebook business page, our business shows in the dropdown for WhatsApp Business Account but does not for WhatsApp Business
    • Files in Teamspaces: keep your team's documents where the work happens

      Release Note: This feature is available for all accounts across all DCs Hello Everyone, A Teamspace is built around a specific team and a shared objective, and it holds the modules and projects that team works with every day. The document that team depends
    • Script to access a CBPX file from zoho crm

      Hello everyone, I'm planning to write a script in Python or Java in Zoho CRM functions, to access a CBPX file. Is it possible to write this script in the dev console of Zoho? What are the best practices to do this ? Would you have references in the Zoho
    • Calculate hours

      Is there any chance that the the "formula" will have the ability to do calculation using the "time" field in the future? Our company has a form set up for tracking hours worked and we use 2 time fields currently. One for the clock-in time, and one for the clock-out time. It's great for keeping that record, but if there were a way to calculate the hours to show on the report would be awesome. Previously we had used JotForm and their calculator had that ability, but it seems that Zoho doesn't accept
    • Introducing parent-child ticketing in Zoho Desk [Early access]

      Hello Zoho Desk users! We have introduced the parent-child ticketing system to help customer service teams ensure efficient resolution of issues involving multiple, related tickets. You can now combine repetitive and interconnected tickets into parent-child
    • Zoho Books | Product Updates | November 2026

      Hello users, As the year winds down, we've introduced several enhancements to make compliance, inventory management, and everyday bookkeeping easier in Zoho Books. This month's updates include an improved TDS experience, a new way to exchange transactions
    • Sheet co-edit: no live presence — also on Collaborate demo?

      Two Sheet co-edit sessions open OK (same document_id, document.edit: true), but there’s no real-time collaboration: no cell highlights, Group Chat → Users stays empty. Writer co-edit works on the same Office Integrator setup. We see the same on the official
    • Zoho Writer workflows now support custom stages, parallel reviews, and external approvers

      Hello everyone, Zoho Writer now lets you build your own approval chains. The pre-built workflows also get new review modes, completion criteria, and external approver support. What’s new Custom workflows: Design review and approval processes from scratch,
    • Expanding sales, marketing, and support capabilities in Zoho CRM Plus 3.0

      Hey everyone, It's been more than 10 years since we launched Zoho CRM Plus back in 2014. This is quite a milestone, and we've come a long way in empowering you with everything you need to offer an exceptional customer experience. On that note, we expanded
    • Erase function in Zoho PDF editor does not truly redact

      Using the "erase" function in the Zoho PDF editor online does not redact the text underneath when opening the file in Adobe. When I used the erase function to whiteout the areas I didn't want to be seen, I opened the supposed redacted files in Adobe.
    • Error creating an XML file

      I am creating an xml as string in the function Employee.generatePartA_XML_String, and then I want to save it as a file to the field "Part_A_XML", but I get the response: {"code":3700,"message":"Unable to upload a file. Please check and try again."} How
    • Thunderbird cannot authenticate Zoho on android

      I keep getting a message from Thunderbird on Android that it could not authenticate for my account, dadashton@zoho.com., and to update my server settings. Now the settings are exactly the same for my other devices (1 Windows, 1 Mac and 2 Linux) Can anybody
    • Mailchimp Integration

      Hello, I am needing some help. Does anybody have a recommended source for information on the Zoho-Mailchimp integration. We are working on a system to import large amounts of records into Zoho that will sync into Mailchimp for us to run a mail campaign out of. Let me explain what the process we are trying to implement - any information or advice is appreciated. Import record data base into Zoho Leads module --> use Lead source to ID records that are part of this mail campaign Zoho Leads (specific
    • [Free webinar] Zoho Creator meets AI with MCP | Creator Tech Connect (November 2026)

      Hello everyone, We are excited to invite you to another edition of the Creator Tech Connect webinar. About Creator Tech Connect The Creator Tech Connect series is a free monthly webinar consisting of purely technical sessions, where we dive deep into
    • Invalid Client - Client ID passed does not exist

      I tried connecting the Zoho campaign with the "Uncanny Automator". It shows an error " Invalid Client - Client ID passed does not exist". There is no option to add manual API. URL: https://accounts.zoho.eu/oauth/v2/auth?response_type=code&client_id=1000.MSFIUOA1G8YBK7IFRL9Z0NINM6DW9C&scope=ZohoCampaigns.contact.ALL&redirect_uri=https%3A%2F%2Fapi.automatorplugin.com%2Fv2%2Fzoho-campaigns&prompt=consent&access_type=offline
    • Field of Lookup - 5 Field Association Limit.

      This query relates to the post at: https://help.zoho.com/portal/en/community/topic/introducing-the-field-of-lookup-in-crm-public-early-access-2023 My simple (and common) scenario: I select an account / customer lookup and want their address pulled into
    • Task status - completed - other options

      I have a dumb question I know i can make custom statuses for the tasks - but is there anyway to make additional "completed" statuses like for instance if i have a task "call back customer" and i leave a vm for them to call back marking it "completed -
    • #20 I've Sent It and It's Wrong

      Meera spots a mistake in an invoice just four minutes after sending it. She has billed a photoshoot at the half-day rate instead of the full-day rate. Her first thought is to delete the invoice and start again. But is deleting the right thing to do? It
    • Zoho Forms API

      Is there any way to get all form entry list using API? Looking forward to hear from you
    • BNZ Bank Feeds No Longer Available

      The BNZ (New Zealand) bank feeds are still failing and it's been months since they last worked! Uploading bank statements (CSV's) mean waiting to the end of the month when they become available. It is unacceptable to keep my clients waiting for payment
    • MCP is now easier to access and configure in Bigin

      Greetings! We hope you're all doing well. We've previously introduced Zoho MCP for Bigin, which lets you connect Bigin with AI tools and interact with your Bigin data using natural language. Now we're making MCP easier to access and configure directly
    • Launch agents from more custom button locations and attach files in Ask Zia

      Hello all, Your agents now meet your team where the work happens. You can add agents to custom buttons in list views, create and edit pages, and related lists, so users launch them without leaving the page they’re on. What’s new Agents in more custom
    • Phone system to integrate with Zoho CRM

      I am looking for phone software that would allow my agency to do the following within Zoho CRM: Make calls from zoho Track calls and notes Leave pre-recorded messages after reaching voicemail of lead Only 2 members, so need company who will allow just
    • Introducing PRM: Build, manage, and scale your partner ecosystem

      Growing a partner ecosystem is a good problem to have. What starts as a handful of partners can quickly turn into a maze of spreadsheets, emails, and disconnected processes. More partners mean more opportunities, greater reach, and new ways to grow
    • Zoho Projects connector with Zoho CRM (Related List module) features

      Hi community, I use Zoho Projects connected to Zoho CRM, where we associate Projects with Deals, clients, etc.. I am looking to change/edit the fields that are available in the integration. Currently it shows Project Status, Project Completion, Milestones,
    • Feature Request: Render Markdown (.md) files in Zoho Cliq

      Hi, We regularly share Markdown (.md) files in Zoho Cliq. However, when we open these files in Cliq, the content does not render as Markdown—it displays as plain text. This forces us to copy/paste the content into an external Markdown viewer to read it
    • Free webinar: Zoho Sign for Microsoft apps

      Hello, Did you know Zoho Sign works right inside the Microsoft apps you already use? A signature request shouldn't mean leaving Teams for another tab, or downloading an Outlook attachment just to sign it. Zoho Sign integrates with Microsoft 365, Teams,
    • Next Page