# Setting up connected chats

Chat type, who each chat is with, the properties it is about and everyone's role, so a request for the owner reaches the owner group and not the cleaners.
Page: https://app.proptonomy.ai/docs/connected-chats

## Why chat setup matters (https://app.proptonomy.ai/docs/connected-chats#why)
When someone asks Proptonomy to “ask the owner of Maple House”, it has to find the one chat where that owner is. It decides from how each chat is set up, not from what the chat is called.

A chat that is set up completely says three things: who is on the other side, which properties it is about, and who each person in it is. With all three, the owner’s request goes to the owner group and a cleaning note goes to the cleaners. With one missing, Proptonomy has to guess, and a cleaners’ group that mentions the property in its description can look like the right place.
- Chat type: Public, Admin or Internal. Who may see what is posted there, and whether team messages and escalations can go to it.
- Who the chat is with: Owner, Cleaning crew, Team, Guest, Maintenance, Vendor or Mixed. Proptonomy suggests one; it is used only once a person confirms it.
- Linked properties: The properties the chat is about. An owner group is linked to that owner's properties.
- People and their roles: Each person in the chat as a contact with the right role: owner, staff member, coordinator and so on.

## Pick the chat type (https://app.proptonomy.ai/docs/connected-chats#chat-type)
Set when the chat is connected, and changed on the chat's row in the integrations settings.
- Public: a chat with people outside your company: an owner group, a guest, a vendor. Team messages and escalations never go here.
- Internal: your own people, cleaners included. Use it for a cleaning crew’s group so cleaning work can reach it.
- Admin: your operations chat, where escalations and reports land.

Limit: A cleaners' group set to Public receives no team messages. If your cleaners’ group is set to Public, Proptonomy treats it as guest-facing and never sends cleaning work there. Set it to Internal.

## Confirm who each chat is with (https://app.proptonomy.ai/docs/connected-chats#who)
Proptonomy suggests who is on the other side of every connected group from its members and messages. The suggestion does nothing until someone confirms it.

Each row shows the suggestion and the reason for it. Press Confirm when it is right, or Change to pick another. Check each one: a suggestion can be wrong when the people in a chat are not yet known, for example an owner group whose owner writes from a number that is not on their contact.

You can also tell Proptonomy in your operations chat, for example “the Maple House group is the owner’s chat”.

## Link the chat to its properties (https://app.proptonomy.ai/docs/connected-chats#properties)
A chat linked to no property counts as covering all of them. Link every owner, cleaner and vendor group to the properties it is about.

In an operations chat you can also say it in words: “this is the cleaner chat for Maple House and Birch Cottage”. Only your admins can change another chat’s setup.

## Give everyone in the chat a role (https://app.proptonomy.ai/docs/connected-chats#people)
Proptonomy decides how much a message is worth by who sent it. A person without a role is treated as unknown.
- Owners: register them as the owner on the property (the property’s Owners section, Add owner) and give their contact the Property owner role. If the owner writes from a different number than the one on their contact, update the contact so their messages are recognised.
- Your team: give each person the role they really have. A team member left as Viewer is not counted as your team. See Which role for whom (https://app.proptonomy.ai/docs/roles#which-role).
- Cleaners and handymen: Staff member, or link them to their company as a partner.

Change a role on the contact page, or tell Proptonomy in your operations chat: “make Kari a cleaner”.

## Merge duplicate contacts (https://app.proptonomy.ai/docs/connected-chats#duplicates)
One person can end up as two contacts, for example once from a booking and once from WhatsApp. Merge them so their messages and roles meet in one place.

Limit: A contact keeps one phone number and one email today. Merge two contacts only when they share the same phone number or email. When they have different numbers, one number is dropped and the next message from it creates a new contact again.

## Checklist for a new owner group (https://app.proptonomy.ai/docs/connected-chats#checklist)
1. Connect the group as Public See Connecting a chat (https://app.proptonomy.ai/docs/whatsapp#connect).
2. Link it to the owner's properties Settings, Integrations, the chat, Edit routing, Property scope.
3. Confirm it as the owner's chat Settings, Routing, Confirm who each chat is with.
4. Check the owner's contact Registered as owner on the property, role Property owner, and the number they write from on their contact.
5. Give your team in the group their roles Nobody left as an unknown member or as a Viewer by mistake.
