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.
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.
Note: 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.
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
Recent Topics
Duplicate Record Creation
Hello Team, I would like to check whether there are any options available in Zoho FSM to prevent duplicate record creation in the following modules: Assets Companies Contacts Ideally, we would like the system to check for existing records before allowing
集めて終わりにしない。― Zoho FormsからCRMへデータをつなぐ
ユーザーの皆さま、こんにちは。ゾーホージャパンの友田です。 Zoho Formsで問い合わせや資料請求を受け付けた後、その情報をどうしていますか? 例えば、 フォームから届いた氏名や会社名、メールアドレスを確認して、Zoho CRMにも同じ情報を入力している。 そんな作業が発生している場合、FormsとCRMをつなぐことで、その手間を減らせるかもしれません。 Formsに入力された情報をCRMへ Zoho Formsは、Zoho CRMと連携できます。 例えば、Webサイトから資料請求を受け付ける場合、
Zoho Inventory - Imporoved Order Fulfillment Reporting
Hi Inventory Team, i've tried to contact you through support@eu.zohoinventory.com but haven't received a response. I am contacting you on behalf of a client. Our client is a car parts wholesale business and we set them up on Zoho Inventory earlier this
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
How to embed Google Analytics GA4 tracking on a standalone Public Page (outside Customer Portal)?
Hi, Is there an official or recommended way to embed Google Analytics (GA4) tracking directly onto a standalone public Zoho Creator Page (outside of a Customer Portal)? I’m considering using an invisible Custom JS Widget as a workaround, but I’d love
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
Zoho CRM calendar merge with outlook
Hi Zoho team! I did the steps for syncing the zoho CRM calendar with outlook. Everything works well as long as the user creates meetings inside the newly created Zoho CRM calendar in outlook, but I need a way to also display the meetings which are received
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
Trigger a Workflow Function if an Attachment (Related List) has been added
Hello, I have a Case Module with a related list which is Attachment. I want to trigger a workflow if I added an attachment. I've seen some topics about this in zoho community that was posted few months ago and based on the answers, there is no trigger
Bills import rejects the Account column (The account does not exist), although the accounts exist in the Chart of Accounts
Hello Zoho Books Team, I am unable to import bills into my Zoho Books. The import keeps rejecting the Account column, even though the accounts exist and work when I create a bill manually. What I am doing Bills > Import Bills, CSV/XLSX file, 145 rows,
How do I reorder the item table columns in my invoice template?
There must be a way I just cannot find it. Anyone?
Zoho Desk API returning 403 SCOPE_MISMATCH for Ticket Search API
Hello Zoho Support Team, We are experiencing an authorization issue with the Zoho Desk Ticket Search API. Our integration was working correctly yesterday, but we are now receiving the following error when calling the Search Tickets endpoint: API: GET
Free webinar: Zoho Sign in Q3 2026
Hi there! From smarter signing on your Apple devices to new ways to verify and personalize your documents, Zoho Sign had a busy Q3—and we're bringing it all together in one session. Join us for a complete walkthrough of everything new this quarter, plus
Zoho Desk - Delete an email conversation
When using Zoho support desk I see an option to delete and edit conversations that are comments, BUT if the conversation was automatically added as a conversation from an email, then the option to delete it seems not to be available. Is there a way to
Messages do not open and I cannot reply to messages in Zohodesk
Hi, this is an unusual behaviour. I cannot reply to messages: Accessing a draft message - runs endlessly. Sending Emails fail:
Join Zoho Meeting only via Web browser and not with Zoho Meeting App
Dear Zoho team, according to the documentation [1], Zoho Meeting only offers web view for Chrome and Firefox on a desktop. For other browsers and devices, participants can only join a Zoho Meaning with the Zoho Meeting App installed. This is a big hurdle
Link item in purchase order to Customer
Is it possible to link each item in purchase order to a customer which would create an associated list, so I can easily find where, when and what my customer have order from us. Thanks!
Passing the CRM
Hi, I am hoping someone can help. I have a zoho form that has a CRM lookup field. I was hoping to send this to my publicly to clients via a text message and the form then attaches the signed form back to the custom module. This work absolutely fine when
I want to test some payment subscription with a test credit card from stripe
I have a test customer and place https://stripe.com/docs/testing#international-cards test credit card number to the Add New Card in subscription.zoho customer page. After I added, the test card was declined. Am I missing something?
This user is not allowed to add in Zoho. Please contact support-as@zohocorp.com for further details
Hello, Just signed up to ZOHO on a friend's recommendation. Got the TXT part (verified my domain), but whenever I try to add ANY user, I get the error: This user is not allowed to add in Zoho. Please contact support-as@zohocorp.com for further details I have emailed as well and writing here as well because when I searched, I saw many people faced the same issue and instead of email, they got a faster response here. My domain is: raisingreaderspk . com Hope this can be resolved. Thank you
Strengthen your account security with Password Policy
Still using the same password for all your accounts? Or perhaps your password is easy to guess or follows a predictable pattern? If so, your account could be at risk. Once someone gets hold of a password that you reuse, they could potentially gain access
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
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
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
Zoho Forms - Feature Request - Embed iFrame or Dynaic URLs in Description fields
Hi Zoho Forms team, I'm working with a client who uses Zoho Forms internally to collect information over the phone from potential work placement candidates. At the end of the form, the candidate needs to be booked in for an induction, which we've configured
New in Office Integrator: Add text, diagrams, and drawings to your spreadsheet
Hi users, We are pleased to introduce the Shapes feature in Zoho Office Integrator's spreadsheet editor. It lets users create visual elements; including simple shapes, text boxes, freehand drawings, and structured diagrams; directly within the spreadsheet.
Highlight what matters, erase what doesn’t in PDFs
When reviewing PDFs or preparing them for sharing, two things often come up: you want to draw attention to what’s important, and you want to hide what isn’t. Zoho PDF Editor gives you both capabilities in one place with its highlight and erase tools.
WorkDrive Desktop Sync Is Being Deprecated: Move to WorkDrive TrueSync for a Smarter Experience
Hi everyone, We are excited to share a better, smarter way to access and manage your files directly from your computer! We’re transitioning from our legacy Desktop Sync app to WorkDrive TrueSync, designed to give you faster performance,greater flexibility,
Set connection link name from variable in invokeurl
Hi, guys. How to set in parameter "connection" a variable, instead of a string. connectionLinkName = manager.get('connectionLinkName').toString(); response = invokeurl [ url :"https://www.googleapis.com/calendar/v3/freeBusy" type :POST parameters:requestParams.toString()
Introducing the Zoho Campaigns MCP server
Hello everyone, We are pleased to announce that Zoho Campaigns is now available in Zoho MCP. You can now connect your Zoho Campaigns organization to AI tools such as Claude, ChatGPT, GitHub Copilot in VS Code, and Cursor, and manage your email marketing
SubForm Custom Sort - Deluge Workflows
I have been experimenting with the Custom Order function of Subforms, it works beautifully within the subform itself and retains the sorting order. However, I need to be able to iterate through the records in Deluge using the sort order (The usage case
Bank feeds automation is broken - requires manual intervention and authentication
Yodlee supports Australian Open Banking CDR protocols natively, but Zoho Books' implementation is still triggering legacy screen-scraping MFA blocks on CBA and other business banking accounts. When will Zoho update its Australian bank feed pipeline to
Cannot Access Subform Display Order in Deluge
As highlighted in this community post, we still have to deal with the significant limitation of not being able to access the user-sorted order of subform rows through Deluge. This creates a major disconnect between the UI capabilities and backend automation,
Process FOR loop for subform items in the order of the manual sorting
Hi Guys, I have searched everywhere and tried everything, but I still not able to resolve one particular challenge. I have a subform in my Invoice with rows for each item. I made it so that we can change the order of the items manually. I need to be able
Augmenting subform capabilities
Greetings, everyone! Finally, the day has come for us to announce some of the most anticipated, requested, and exciting updates to subforms in Zoho Creator. As you're aware, subforms are an integral part of Creator forms, as they help in establishing
Build appointment scheduling into your vibe-coded apps with Zoho Bookings
Exploring vibe coding? Wondering how an app built with AI can handle appointment scheduling? Join our upcoming live webinar to discover how Zoho Bookings APIs can help connect applications to scheduling capabilities. Here's what we'll explore: • Show
Is there a way to make Reason For Loss field mandatory at Closed Lost stage?
Hi guys, Reason For Loss system picklist appears on Verify Details page but it is not mandatory so as a result, AEs tend to omit it (leave at default value -None-). Is there a way to make it mandatory at Closed Lost? I tried layout rule but this field
Cannot reorder fields in Page Layout in Expenses and Purchase Requests
It is very inconvenient that the custom fields in Page Layout cannot be re-ordered. The only way is to remove the fields and re-create them; however, it is impractical. This would affect the reports and dashboards we are having. Not able to re-order the
Request for Zoho Desk Version and Module Details
Kindly help us confirm the version of Zoho Desk currently being used in our portal, along with the module/edition name. We require this information urgently for our internal documentation.
How to customize the displayed name of contacts in Trident?
Hello, For work purposes, I sort different customers into different folders, and I also change their display names in Contacts so I can easily recognize them later. However, Trident doesn’t seem to support this. Even after I edit a contact’s name in Contacts,
Next Page