Overview
During a conversation people routinely correct and complete their own details: "actually my email is a different one", "take down my tax ID for the invoice", "I moved to another city". Until now, the Bot could read the whole profile and correct nothing β somebody had to reread the conversation afterwards and retype it into the record.
The Bot now writes that data while it talks. There are six capabilities: three for the Contact and three for the Company.
| What the Bot fills in | Where |
|---|---|
| Name, email, phone, external identifier and country | Contact |
| Tax ID (CPF/CNPJ) and legal type | Contact |
| Main address or billing address | Contact |
| Legal name, website, domain, industry, size, lifecycle stage, email, phone, timezone and description | Company |
| Tax ID (CNPJ) and legal name | Company |
| Company address | Company |
Three guarantees hold it together: the Bot only records what the person just told it, the contact is always the one in this conversation (it cannot write onto somebody else's record), and every successful write leaves an audit note in the conversation.
Prerequisites
- Maestro enabled and a Bot configured on the inbox.
- An autonomy level set on the Bot β it decides whether the write runs straight away or waits for approval (see "Settings & options").
- The three Contact capabilities are built in: every Bot already has them, which is why they do not appear in the tool list to be ticked.
- The three Company ones are regular tools and must be ticked in the Bot's configuration:
crm_org_update,crm_org_set_fiscalandcrm_org_set_address. - Also tick
crm_list_organizations: that is how the Bot finds out which company to update. Without that lookup it cannot identify the record and writes nothing. - The Companies module must be available on the account.
Step by step
- Open the Bot configuration and confirm the autonomy mode.
- In the tool list, tick the Company ones (
crm_org_update,crm_org_set_fiscal,crm_org_set_address) and thecrm_list_organizationslookup. The Contact ones are already on. - Save and work normally. When the person gives a detail β "note down my tax ID:β¦" β the Bot records it on the record.
- In Hybrid (Require approval) mode the write is held and becomes an approval card in the Maestro panel, with a private note mentioning the assignee. Open it and choose Approve or Reject. In Autopilot it runs straight away.
- Check the result on the contact profile (or the company record) and the audit note logged in the conversation.
Settings & options
Contact fields
| Field | Expected format |
|---|---|
| Name | Text |
| Email address | |
| Phone | E.164, with country code (e.g. +5521999999999) |
| Identifier | This person's external id in your system |
| Country | ISO-3166 alpha-2 (e.g. BR) |
| Tax ID | The digits as the person gave them; the type (cpf/cnpj) can be inferred |
| Legal type | Individual or company |
| Address | Street, number, complement, district, city, state, postal code and country |
| Billing address | The same fields, stored separately from the main address |
The Bot chooses between the main address and the billing address from the context of the conversation. If the person explicitly says it is the invoicing address, have that said in the conversation β that is what drives the choice.
Company fields
| Field | Note |
|---|---|
| Trading name | Commercial name |
| Legal name | Registered name |
| Domain / Website | acme.com / full URL |
| Industry | Sector |
| Size | Headcount band (e.g. 11-50) |
| Lifecycle stage | E.g. lead, customer |
| Email and phone | Phone in E.164 |
| Timezone | IANA standard (e.g. America/Sao_Paulo) |
| Description | A short description of the company |
| Tax ID and legal name | Tax identity, to invoice it or put it on a contract |
| Address | Street, number, complement, district, city, state, postal code and country |
Autonomy: there is no new switch
All six capabilities count as sensitive actions β exactly the same treatment as CRM, Calendar and Payments writes. That means:
| Bot mode | What happens to the write |
|---|---|
| Autopilot | Runs straight away. |
| Hybrid (Require approval) | It is held waiting for human approval, in the usual panel. |
| Copilot | Nothing goes out without your review. |
There is no separate toggle just for contact data: what governs it is the Bot's autonomy level.
Use cases
- Issuing an invoice: the customer gives the tax ID and address mid-conversation, and the record comes out ready for billing.
- Closing a contract: the company's legal name and tax ID recorded on the spot, with nobody retyping them from the history later.
- Billing: email and phone corrected the moment the person says they changed β the payment link starts arriving in the right place.
- Delivery: a billing address kept separate from the main address.
- B2B qualification: the company's industry, size and lifecycle stage filled in from what the contact says, feeding segments and reports.
Tips, limits & best practices
- A stored document comes back masked β and the Bot refuses to rewrite it. A stored tax ID is
returned on read as
***. If the Bot tried to "confirm" that masked value, it would overwrite the real document with a mask. So it refuses and asks the person for the document instead. The Bot only stores a document it has just heard in the conversation. - A partial address is merged, never replaced. If the person gives only the city, the postal code and street already stored stay there. The same holds for every field: anything not said keeps its stored value. An incomplete answer never wipes a record.
- The contact is always the one in this conversation. The Bot cannot be pointed at somebody else's record β that is exactly how one customer's document would land on another's profile.
- The company, however, is found by lookup. If the account has two similarly named companies, ask the contact for the full name or the tax ID before requesting an update β the write lands on the record the Bot found.
- The audit note only appears when the action succeeded. If the write failed, there is no note claiming it was done.
- Start on Hybrid. Identity data is sensitive: review a few approvals before moving to Autopilot.
Troubleshooting
- "The Bot said it noted it down, but the field did not change": the mode is Hybrid and the action is held. Open the Maestro panel in the conversation and approve it.
- "The document was not saved": the value sent was masked (read from the record, not given by the person). Ask for the document in the conversation and record it again.
- "The Bot does not update the company": the Company tools are not ticked in the Bot
configuration, or the
crm_list_organizationslookup is missing so it cannot find the record. - "The address came out incomplete": the Bot records only what was said. Ask for the missing parts β they are added to what already exists, wiping nothing.
- "It updated the wrong company": there was more than one record with a similar name. Fix it on the company record and, next time, confirm the full name or the tax ID first.
- "I want it to stop touching the record": use Copilot (nothing goes out without you) or untick the Company tools. The Contact ones follow the Bot's autonomy level.