Zones
Group your team by zone, with its area, service days and hours and a per-slot limit, and let each task find its own zone.
Updated:
A zone is a group of people with an area and service days and hours. It works for deliveries, technical visits, routes or any job done at the customer's address: for example, the North Zone serves Tuesdays and Thursdays and the South Zone, Wednesdays and Fridays.
Create a zone
In My business → Team and resources, tap Add and choose Zone. Each zone has:
- Name.
- Area: text and/or an area drawn on the map, as explained below.
- People: the ones who serve the zone. A person can belong to several zones.
- Days and hours: for example Tuesday and Thursday from 9 to 6. If you leave it empty, the zone does not restrict days.
- Per-slot limit (optional): the maximum number of tasks that fit in each time slot of the zone.
You can also ask Wagy: "North Zone, Tuesday and Thursday, Camila and Diego". Wagy builds the plan, you review the change and confirm it.
Define the area
You can combine two ways to define a zone's area:
- By text: add neighborhoods, cities, provinces or states, countries or postal codes as tags. A postal code matches by prefix:
20covers every code that starts with 20. - On the map: draw a polygon or pick a point and a radius around it, for example 3 km.
Each way is optional, but you need at least one. A zone with neither text nor a drawn area can never receive tasks, so it cannot be saved.
How the zone is assigned
Each task with an address finds its zone by itself, in this order:
- By the map: if the address has coordinates and there are zones with drawn areas, it looks for the area that contains that point. If several contain it, the smallest area wins.
- By text: if no area contains the point, or coordinates or drawn areas are missing, it looks for a postal code match first, then a neighborhood, then a city, ignoring accents and capital letters.
- No matches: the task stays without a zone and shows up in Today → Needs your attention. Fixing the address automatically runs the zone search again.
If the postal code is written inside the address (for example “25 de Mayo 1530, W3230AIZ Corrientes” or “Rua A, 1 - 20520-000”), it counts too; the street number is never taken as a postal code. In Argentina, a zone with W3230 or 3230 covers W3230AIZ. A bare 4 or 5 digit number only counts when it is labeled, like “CP 3230” or “ZIP 10001”.
When you create a zone, change its area or deactivate it, open tasks (overdue ones too) look for their zone again, and the message after saving says how many now have a zone. Times are never moved: if a task lands in a zone that does not work that day, it keeps its time and you reschedule it if needed. A task already in another zone only changes if the zone you saved fits it better.
In Work you can filter by zone or see only what has no zone, and on the map each task shows its zone.
For delivery businesses
Draw the area and keep a few postal codes or neighborhoods as a fallback. If a badly written address, such as “eso 5”, could not be placed on the map but has a matching postal code or neighborhood, the task still finds its zone by text.
Examples
- A point inside two areas: the address falls inside both North Zone and Center Zone. Since Center Zone has the smaller area, the task gets Center Zone.
- No coordinates, with a postal code: the address has postal code
20040-020and North Zone has the tag20. The task gets North Zone by the prefix. - No coordinates or matching text: the address says “eso 5”, with no postal code, neighborhood or city. The task stays without a zone, in Today → Needs your attention.
Coverage
Your coverage is the sum of all your active zones: whatever falls inside a zone you serve; whatever falls outside all of them is out of coverage. If you have not created zones yet, there is no limit (only the business country), as before.
Besides neighborhoods, cities and postal codes, a zone's area can be a whole province or state or a country.
What happens with an out-of-coverage order
In Zones, the Coverage card at the top lets you choose:
- Take it anyway and notify me (the default): the task is created with the
fuera-de-coberturatag and shows up in Today → Needs your attention, so you decide. - Do not take it: the bot tells the customer «For now we don't reach that area» and creates nothing.
Deliveries that reach certain zones
Each delivery service has Reaches: all zones (default) or these zones. A delivery that doesn't reach the customer's zone follows the same Coverage setting:
- with Take it anyway and notify me, the bot offers it and takes the order, and the task gets the
fuera-de-coberturatag, just like an address outside all your zones; - with Do not take it, once the customer's address is known the bot doesn't offer it, and if the customer asks for it anyway it replies «That delivery doesn't reach your area yet» and creates nothing.
If a detail needed to tell the zone is missing, the bot neither rejects nor hides anything.
How the bot locates the address
The bot looks the customer's address up inside your coverage, so it does not confuse a street with a namesake in another city. Each neighborhood or city you typed in an area is located once, when you save the zone.
- A single result inside the coverage that includes the house number: accepted.
- The street was found but not the number: the bot asks for the number or for the customer to share their location; it does not store an approximate point.
- The customer names another city («…, Santo Tomé»): the bot searches that city and, if it is outside, applies what you chose for out-of-coverage orders.
- Several possible results: the bot offers up to 3 numbered options inside your coverage, plus «none», which keeps the address as typed, without a map location. It no longer asks «which city is it in?».
When the address is precise, the confirmation includes a Google Maps link, on every channel.
For integrations and assistants
- API:
GET /v1/zones/coverage(read, key withconfig:read) andPUT /v1/zones/coveragewith{"out_of_coverage": "take" | "reject"}(Owner and Manager,config:write). The area type also acceptsstateandcountry, and a service hasreach_zone_ids(empty = all zones), changed withPATCH /v1/services/{id}. - MCP: the
get_coverageandset_coveragetools. See MCP. - Wagy can propose zones with these types and explain your coverage.
Times and the bot
When a delivery or visit has a time, only the zone's days and hours are offered, crossed with the availability of its people and the per-slot limit. The bot asks the customer for their address and says, for example: "For your zone (North Zone) we serve Tuesday or Thursday".
Unclaimed tasks
An unclaimed task in a zone is announced, and offered for Take, only to the people in that zone. Owners and Managers see them all and can assign them to anyone.
The "zone" used to be a resource with capacity. Those resources keep working; the migration command converts them into zones without losing any task.
In Work teams, each team shows the zones served by its members and who covers each one. The relation comes from people shared by the team and zone. Zones without work-team members are also managed in this section.