Farmer Bot
Farmer Bot is the chat assistant your farmers use on WhatsApp or Telegram. A farmer linked to their supplier record can answer surveys, map plots, see and share their own records, and ask farming and plant-health questions.
Open Farmer Bot
Section titled “Open Farmer Bot”- Go to Configuration → Farmer Bot.
- Use Overview, Users, Conversations, Broadcasts, and Analytics. Config and Usage are not on this page.
If you do not see Farmer Bot in Configuration, ask an administrator.
Invite a farmer
Section titled “Invite a farmer”Inviting links a farmer’s chat to their existing supplier record.
- Open Users.
- Click Invite to bot.
- Choose the supplier and click Generate link.
- You get a Telegram link and, when your organisation has a WhatsApp number, a WhatsApp link. Copy a link, or click Open in WhatsApp to try it yourself.
- To text the invite instead, choose Telegram or WhatsApp under Send SMS with, then click Send by SMS. The SMS goes to the supplier’s main contact phone.
The farmer opens the link. On WhatsApp they send the message that is already written for them. Their chat is then linked to the supplier, and any survey they had left half-finished in the bot is stopped.
Each new link replaces the previous one for that supplier, so send the latest link.
Farmers who register themselves
Section titled “Farmers who register themselves”A farmer who is not in Orijin yet can send any message to your organisation’s WhatsApp number or to the Telegram bot. After choosing a language, they fill in your organisation’s self-registration survey and become a new supplier. Which survey is used is set in the survey configuration.
What farmers can do in the bot
Section titled “What farmers can do in the bot”Farmers send menu at any time to see their options:
| Option | What the farmer gets |
|---|---|
| Ask a question | An answer about farming that uses their own record: plots, crops, certifications and purchases |
| Check a sick plant | A diagnosis from a photo, with practical next steps |
| View / share my plot map | A link to their plot map, with GeoJSON and KML downloads |
| See what I submitted | A link to their last submitted survey |
| My purchases | A link listing every purchase, with totals and a CSV download |
| Map a new plot | A guided plot boundary capture |
| Update my details | Their survey again, to correct or add information |
| Language | English, Spanish or French |
Share links open in any browser without a login, so a farmer can forward them to a buyer or a cooperative. A link expires after 90 days; the farmer can ask the bot for a new one at any time.
The plant diagnosis is guidance from a photo, not a certified diagnosis.
Follow a conversation
Section titled “Follow a conversation”- Open Conversations.
- Open a thread to read it.
Chats are flagged when a farmer types a question, or when a plant diagnosis fails or is uncertain. The flag shows why, including the suspected disease. On Telegram you can take over a chat and reply. On WhatsApp you can read chats but not reply from the dashboard yet.
Send a broadcast
Section titled “Send a broadcast”- Open Broadcasts.
- Click Create broadcast.
- Enter a title and message, then create it.
- Send the draft from the list.
A broadcast only reaches farmers who have already started the bot on Telegram. WhatsApp broadcasts are not available yet.
See how farmers use the bot
Section titled “See how farmers use the bot”Analytics shows what farmers ask and how the bot answers, without reading every chat.
- Open Analytics.
- Choose a Period. If your suppliers have locations, choose a Location level (for example province) and a Location to see only the farmers there.
- Read the figures at the top: farmers registered and invited, farmers who registered themselves, farmers active in the last 30 days, questions answered with the median reply time, plant photos diagnosed, and the share the assistant handled on its own.
The page then shows:
| Section | What it shows |
|---|---|
| Most asked topics | Questions the assistant answered, grouped into topics such as pests and diseases, fertiliser, or prices |
| Photo diagnoses | What was found in plant photos, the average confidence, and how many went to a technician |
| Conversation summaries | Each conversation in two lines: what the farmer asked, what was recommended, and how it ended. Click Open chat to read the full conversation |
| Active farmers per week, Questions and photos per week | The trend over the period |
| Broadcasts | For each broadcast: sent, delivered and replies |
Click CSV or Excel on any section to download that table, for example to use in Power BI.
Topics and summaries are written automatically a short while after a conversation goes quiet. Click Update topics and summaries to process waiting conversations straight away. A conversation ends after 12 hours without messages.
A request counts as passed to a technician when someone from your team replied in the chat within 72 hours, or when the photo diagnosis was too unsure. Telegram does not report when a broadcast is read, so Read stays empty.
Farm work recorded by farmers is not available yet. It will show the treatments farmers record in the chat, and warnings when a product such as copper is repeated too soon.
Bot setup
Section titled “Bot setup”The bot token, webhook, WhatsApp numbers, the assistant’s setup and usage reports are Superuser-only. Ask your Orijin contact if the bot is not configured for your organisation yet.