Skip to content

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.

  1. Go to Configuration → Farmer Bot.
  2. 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.

Inviting links a farmer’s chat to their existing supplier record.

  1. Open Users.
  2. Click Invite to bot.
  3. Choose the supplier and click Generate link.
  4. 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.
  5. 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.

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.

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.

  1. Open Conversations.
  2. 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.

  1. Open Broadcasts.
  2. Click Create broadcast.
  3. Enter a title and message, then create it.
  4. 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.

Analytics shows what farmers ask and how the bot answers, without reading every chat.

  1. Open Analytics.
  2. Choose a Period. If your suppliers have locations, choose a Location level (for example province) and a Location to see only the farmers there.
  3. 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.

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.