🛠 How to use UPí on WhatsApp
UPí is upCampo's artificial intelligence, and it answers on WhatsApp. You write the way you would to a coworker — "how much did it rain this week?", "log 300 liters of diesel on tractor 7230" — and it looks up the farm, answers with the system's numbers right away and, when you ask, records rainfall, fueling, work orders, executions and invoices. It accepts text, voice messages, photos, PDFs, spreadsheets, the field map (KML, KMZ or shapefile) and location.
It is the same system as the web portal and the app: what UPí records shows up on the screens, and what was entered on the screens UPí can see. It also schedules alerts — "let me know when it rains more than 20 mm" —, explained in How to receive UPí alerts and the daily summary.
The path, in five steps
- Enable your number and the AI permissions in the web portal.
- Chat your way: text, voice, photo or file.
- Ask about anything on the farm.
- Record what happened in the field, confirming before saving.
- Register what is missing and schedule alerts.
1️⃣ Before you start: enable your number
File > Users with AI access
The company administrator enables it, in the web portal. For each person:
- WhatsApp number with the country code — for example
5565999998888. That is how UPí recognizes who is writing. A number can only be on one active user; if it is on two, UPí answers questions but does not record anything. - Preferred farm (AI) — the farm UPí works on when the person does not mention one.
- AI permissions, per farm: what it can look up (crops, weather, scouting, work orders, inventory, financial…) and what it can record (rainfall, fueling, work orders, executions, inventory transactions).
The user record itself is created on the Users screen.
2️⃣ How to chat with UPí
- Write your way. There are no commands or menus: UPí understands the question as it comes. You can send it in several messages in a row — it waits a few seconds and puts everything together.
- 🎤 Voice message: say the question or what to record. UPí transcribes it and answers in writing.
- 📷 Photo: send a photo of the invoice, the repair shop receipt or the order — UPí reads it and prepares the invoice entry.
- 📄 PDF: invoice, order, report or lab report of up to 30 pages. UPí reads the content and uses it for whatever you ask — record the invoice, check an amount, summarize. Larger PDF: say which pages matter or send only those.
- 📊 Spreadsheet (Excel or CSV): UPí reads all the sheets, up to 200 rows per upload. It is useful for bulk registration — "register the products in this spreadsheet". A larger spreadsheet goes in parts; UPí tells you what was left out.
- 🗺️ Field map: a KML, KMZ or shapefile (the .zip with the .shp, .dbf and .prj). UPí shows the fields it found, with the area of each one, and saves the map after your "yes" — see step 5.
- 🗜️ .zip file: UPí opens it and reads the PDFs inside (up to 5) and the field map. Other file types inside the zip, such as a spreadsheet or photo, send separately.
- 📍 Location: send the WhatsApp location pin to say where you are — for example, along with an issue found in the field. UPí keeps it in the conversation.
- Pick from a list: when there are options (which equipment, which field) or a summary to confirm, UPí sends a list — tap the button and choose. You can also reply by typing.
- Change the subject whenever you want. Were you recording an execution and remembered to ask about inventory? Ask. If an entry was half done, UPí tells you in one line that it was not saved.
- Wrote while it was replying? No problem: UPí combines the new message with the previous one and sends a single answer.
- Questions about how to use the system: "how do I run a report?", "where do I set up the maintenance plan?" — UPí answers using the articles in this Help Center and sends the article link.
- Talk to a person: "I want to talk to someone on the team". UPí calls the upCampo team, who reply in this same conversation.
- Start over: send just "clear history". UPí forgets the previous conversation — useful when it keeps going back to a subject that is already over.
Which farm? If you don't mention a farm, your preferred farm applies. To switch, say 💬 "now I want the CIMA farm" — if there are similar names, UPí asks which one. The switch applies to the next messages and takes a few seconds. For a single question about another farm, mention its name in the message.
3️⃣ Questions: examples by topic
UPí queries the system for every question — the answer always has the current data, even if you have asked before. The sentences below are examples; write your way.
🌱 Crops, planting and harvest
- 💬 "How many hectares of soybeans are planted this season?"
- 💬 "What is the yield of field 3A?"
- 💬 "How is the second-crop corn harvest going? How much is left to harvest?"
- 💬 "Which variety yielded the most last season?"
Yield comes in sc/ha (grains) or @/ha (cotton), weighted by area. A field only counts as harvested once the harvest has been finalized in the system.
🌧️ Rainfall and weather
- 💬 "How much did it rain this week?"
- 💬 "How much has it rained on field 12 since planting?"
- 💬 "What was the rainiest day in September?"
- 💬 "Accumulated rainfall for the season by sector"
🐛 Pest monitoring (IPM)
- 💬 "What are the latest scouting reports?"
- 💬 "Is any pest above the action threshold?"
- 💬 "How is the caterpillar pressure on field 5 this season?"
- 💬 "Show me the full scouting of field 8 from yesterday"
- 💬 "How long did the scout spend at each point?"
Each pest comes with the level color: 🟢 low, 🟡 medium, 🔴 high (above the action threshold) — the same as in the scouting in the app.
⚙️ Work orders and costs
- 💬 "Which work orders are open?"
- 💬 "How much of WO 00026 has been executed?"
- 💬 "Which orders are overdue?"
- 💬 "How much did inputs cost on field 3A this season?"
- 💬 "Who operated and with which machine on WO 00014?"
- 💬 "How many WOs did Marco enter in the last 10 days?"
"Order", "WO" and "operation" always mean the agricultural work order, even when you mention a machine ("orders for tractor T9"). For the maintenance work order, talk about maintenance, shop, service or repair.
📦 Input inventory
- 💬 "How much diesel is in the fuel station?"
- 💬 "What is below the minimum?"
- 💬 "Is any batch of crop protection product about to expire?"
- 💬 "Balance of all inoculants"
- 💬 "Glyphosate transaction history for the last month"
🚜 Fleet and maintenance
- 💬 "How much diesel did tractor T8 use this month?"
- 💬 "Which machines are overdue for service?"
- 💬 "How much have I spent on the Delivery truck?"
- 💬 "Which maintenance work orders are open?"
⚖️ Post-harvest, bales and contracts
- 💬 "How much soybean have I harvested this season?"
- 💬 "Average bale weight for variety FM 933"
- 💬 "How much is left to ship on contract 125?"
- 💬 "Outbound load tickets this week"
Harvest load tickets and bales always come summed (by field, variety, day…), never one by one — a season has thousands. The full list comes from the report in the web portal.
🧾 Purchasing
- 💬 "Which purchase orders are late?"
- 💬 "What is still to arrive from supplier X?"
- 💬 "Who quoted the lowest price for fertilizer?"
- 💬 "Which requisitions are stuck without a quote?"
💰 Financial
- 💬 "What do I have to pay this week?"
- 💬 "Which bills are overdue?"
- 💬 "How much does customer Y still owe me?"
- 💬 "Bank account balance"
You need the Financial AI permission on that farm. On WhatsApp, financial is look-up only: settling and entering bills is done in the web portal.
🔗 Several topics at once
- 💬 "Do I have enough input for the next application?" — UPí compares the inventory balance with the rate and area of the planned order.
- 💬 "Did it rain a lot around planting time?" — it combines rainfall and planting dates.
- 💬 "Has the fertilizer order arrived and been paid?" — it combines purchasing and financial.
4️⃣ Entries: what happened in the field
For every entry UPí shows a summary with the values and only saves after your "yes".
The summary starts with the type marker (Lcto de chuva/clima, Lcto abastecimento…). If
any data is missing, it asks for everything in a single message. Replying "yes", "go ahead" or
tapping Save in the list saves it right away. The season is always the farm's current one — UPí does not
ask; for another one, mention the season in the message.
🌧️ Rainfall
💬 "It rained 18 mm at the headquarters rain gauge today."
- UPí checks whether there is already an entry for that rain gauge on that day — and tells you, instead of recording it again.
- If the field you mention is covered by two rain gauges, it asks which one to record on.
⛽ Fueling
💬 "I put 320 liters of diesel in tractor T8 02, hour meter 5,548, at the headquarters fuel station."
- If the fuel station has pump control, UPí asks for the start and end readings.
- The equipment reading is in hours or km, depending on the machine. If the equipment requires a reading and you didn't give one, UPí asks for it.
- Outside station (external): liters and amount are enough; the fuel type is optional, as in the web portal.
- The time is not required, and UPí does not ask for it.
- A duplicate fueling (same equipment, day and liters) is rejected: UPí gives the number of the one already recorded.
📋 Work order
💬 "Create a WO to apply gypsum on field Ari 08, 500 kg/ha of agricultural gypsum, to be finished by the 20th."
- UPí looks up the field, the product and the activity type in the records and shows the assembled order.
- Product, rate, crew and date can be adjusted in the conversation before the "yes".
✅ Work order execution
You can send everything in one message, in the format the team already uses:
WO: 00026 Operator: Mateus Gama Equipment: NH SP 3500 04 Start hour meter: 5056 End hour meter: 5060 Start time: 13:00 End time: 17:00 Date: 06/10 Field: 3 arsc Area: all
- Area "all" or "what's left": UPí calculates what is left of the field on that order.
- What is required (equipment, operator, time) depends on the activity type, as in the web portal — UPí only asks for what that order requires.
- Corrected right after? "Actually the end hour meter was 5052" — UPí changes the execution it just saved, instead of recording another one.
- An operator who is not in the employee records goes into the notes; UPí lets you know.
🧾 Inbound invoice (product, part or service)
📷 Send a photo of the invoice — or write: 💬 "Record an expense of R$ 150 for a part on the Delivery truck, from the Retruck store."
- Product for inventory: UPí asks for the storage location.
- Part or service for a vehicle or machine (repair shop, alignment, tire shop): it goes in as a cost for that fleet unit. UPí finds the equipment by license plate or name — a plate written differently on the invoice is also found.
- Standalone item — neither inventory nor fleet, such as a rain gauge bought for use: say "standalone" and UPí records it without asking for a storage location.
- Without an invoice number, the entry goes in as a standalone inbound entry.
5️⃣ Records and alerts
Records. Anyone with permission on the web portal's registration screens can also register by chatting: season, crop, variety, field, planting, activity type, subtype, rain gauge, storage location, product class, product, supplier, equipment type, equipment, employee, crew and nozzle.
- 💬 "Register employee William Funke, machine operator."
- 💬 "Register tractor T8 03, John Deere 8R 410, year 2024."
- 💬 "What is still missing in the farm setup?"
- 📊 Attached spreadsheet: 💬 "Register the products in this spreadsheet."
- 🗺️ Attached map (KML, KMZ or shapefile): 💬 "This is the farm map, register the fields."
Field map. UPí shows a preview — the fields it found, the area of each one and what it ignored, such as pieces smaller than 0.1 ha — and only saves after the "yes". A field that already exists gets the map; a new field is registered. If the file does not include field names, UPí lists each one with its area and a map link and asks for the names before saving. Shapefiles in UTM or SAD69 are converted automatically.
Before adding, UPí checks whether it already exists and suggests a name following the farm's pattern. The step-by-step setup is in How to set up the farm by chatting with UPí.
Alerts. 💬 "Every Monday at 7 a.m. send me the week's rainfall", 💬 "let me know if 2 days go by without a rainfall reading" — see How to receive UPí alerts and the daily summary.
6️⃣ What is still done in the web portal
On WhatsApp UPí looks up all of this, but entering it is still done on the screen:
- harvest load tickets, outbound load tickets and contracts;
- purchase orders, requisitions and quotes;
- fleet maintenance work orders (open, follow up, finalize) — a vehicle service invoice is not on this list: it goes through UPí, as in step 4;
- accounts payable and receivable, settlements and transfers;
- PDF reports.
Load tickets, purchasing, financial and PDF reports already work through UPí in Claude and ChatGPT — see UPí in Claude and ChatGPT.
- questions from the field are answered right away, with the system's numbers, without opening the web portal;
- whoever is on the machine records rainfall, fueling and executions from their phone, by text or voice;
- the setup moves forward with what you already have: spreadsheets, PDFs and the field map;
- nothing is saved without you seeing the summary and confirming;
- what matters arrives on its own, through alerts.
Learn more about UPí at upcampo.com.br/upi.
❓ Frequently asked questions
UPí doesn't answer me. What could it be?
It is almost always the number: it must be registered, with the country code, on an active user, on the Users with AI access screen of the web portal. If the user exists but does not have UPí enabled, it replies saying so — ask the administrator for the AI permissions. If the number is on two active users, UPí answers questions but does not record — ask the administrator to keep it on just one.
UPí answered about the wrong farm. How do I switch?
If you don't mention a farm, UPí uses your Preferred farm (AI). To switch, say "now I want farm X": UPí switches and the next messages apply to it. For a single question about another farm, mention its name in the message.
Does what UPí records show up in the web portal and the app?
Yes. UPí saves to the same database as the screens: an execution recorded on WhatsApp shows up on the work order in the web portal and reaches the app within a few seconds. In the record, the source is marked as WhatsApp.
I recorded something wrong through UPí. How do I fix it?
Right after saving, say what changed — "actually it was 32 ha" — and UPí changes that same entry, showing the summary first. Older entries are corrected on the web portal screen.
Can I send voice messages to UPí?
Yes. UPí transcribes the voice message and answers in writing, for questions and for entries. Say the numbers slowly — the summary shows what it understood before saving.
What files can I send to UPí?
Photos, PDFs of up to 30 pages, spreadsheets (Excel or CSV, up to 200 rows per upload), field maps in KML, KMZ or shapefile, and .zip files with PDFs or the map. It does not read other types (Word, video): copy the text into the message or send it as a PDF.
How do I send the field shapefile?
Compress the files with the same name into a .zip — the .shp, the .dbf and the .prj (and the .cpg, if there is one) — and send the zip on WhatsApp. Without the .prj, it only works if the map is in latitude/longitude. A projection that is neither latitude/longitude nor UTM (polyconic, Albers) is rejected: export it again in WGS84, SIRGAS 2000 or UTM.
UPí got stuck on an old subject. What do I do?
Send just "clear history". UPí forgets the previous conversation and starts from scratch. Entries and alerts are not affected.
Why doesn't UPí list every load ticket or bale?
A season has thousands of load tickets and bales: UPí always answers with totals, by field, variety or day. For the full list, use the report in the web portal.
Can I talk to a person from upCampo on the same WhatsApp?
Yes. Write "I want to talk to someone on the team": UPí calls the upCampo team, who reply in this same conversation.