Appearance
NetHunt CRM Integration
The NetHunt integration lets your AI sales assistant write qualified conversations into NetHunt CRM, the CRM that lives inside Gmail. During a chat the assistant creates a lead or a deal record, finds or creates the matching contact by phone and links it, sets the record's status, and leaves a link back to the conversation.
At a glance
| You need | Where | Result |
|---|---|---|
| A NetHunt API key and the email you sign in with | NetHunt → Settings → Apps and other integrations | Credentials to paste into MyChatBot |
| Your leads and deals folder names | Your NetHunt workspace | The assistant writes into the right folders |
| The credentials connected to an assistant | MyChatBot → Integrations → NetHunt → Submit | The card shows Connected |
| Fields selected | Entities & Data Fields Configuration → Apply fields | The assistant knows which fields to fill |
What your assistant can do
| Action | What happens |
|---|---|
| Create a lead | Creates a record in your leads folder with the customer's name, phone, source AI-<assistant name>, a Chat Link to the conversation, the status and any field you enabled. The contact is found by phone in your contacts folder, or created, and linked to the lead. |
| Update the lead | Updates the lead the assistant created for this customer earlier, for example a new status or details the customer added later. |
| Create a deal | The same as a lead, in your deals folder. |
| Update the deal | Updates the deal the assistant created for this customer earlier. |
| Add or update the contact | Finds the contact by phone in your contacts folder, or creates it, and saves the customer's name and phone in MyChatBot. It can also link the contact to the lead or deal the assistant created earlier. |
When the assistant creates a lead or a deal, or updates a lead, it also mirrors the status it sets into the customer's funnel status in MyChatBot, so your MyChatBot lead list stays in step with NetHunt. Updating a deal changes the status in NetHunt only.
What data the assistant sees and writes
- Reads: your folder list, the fields of your leads and deals folders, and recent records (to find a contact by phone and to learn which status values exist).
- Writes: new lead and deal records, updates to the records it created, and contacts in your contacts folder.
- Fields: only the fields you tick under Entities & Data Fields Configuration, plus the name, phone, source, contact link and Chat Link that every record gets.
Get your NetHunt credentials
- In Gmail with NetHunt enabled, open NetHunt Settings.
- Go to Apps and other integrations and click Generate API key. Copy the key.
- Note the email address you sign in to NetHunt with. MyChatBot uses it as the username.
- Note the exact names of the folders where leads and deals should go, for example
LeadsandDeals.
Connect NetHunt in MyChatBot
In the app
Go to Integrations — app.mychatbot.app/integration?integration=NetHunt. Pick the assistant in the header dropdown first.
- Select the assistant you want to connect.
- Under Available Integrations → CRM Systems, pick NetHunt.
- Fill in the form:
- NetHunt API Key — the key from step 2.
- NetHunt Username — your NetHunt sign-in email.
- Leads Folder — optional; leave empty to use a folder called
Leads. - Deals Folder — optional; leave empty to use a folder called
Deals.
- Click Submit.
Folder names are fixed once you connect
After you submit, the form fields are locked. To point the assistant at different folders, delete the integration and connect again with the new names.
MyChatBot doesn't test the key when you submit. If the key or email is wrong, you'll find out the first time the assistant tries to create a record, so run the test below straight away.
Set it up
Entities & data fields
- Under Entities & Data Fields Configuration, open the Leads or Deals tab and turn the entity on.
- Tick the fields the assistant may fill. Most used custom fields are fields used in your records over the last few days; the rest are under Other custom fields.
- Turn on Lead Phone Required or Deal Phone Required if every record must have a phone number.
- Click Apply fields.
NetHunt fields arrive as plain text: the assistant isn't given a list of allowed values for a dropdown field, so name the values you expect in its instructions.
Prepare your NetHunt folders
The assistant uses these names unless your instructions say otherwise:
| What | Default name |
|---|---|
| Contacts folder | Contacts, with fields Name and Phone |
| Lead or deal name field | Name |
| Lead or deal phone field | Phone |
| Source field | Source |
| Link to the contact | Contact person |
| Link to the conversation | Chat Link (fixed) |
| Status | Status (fixed) |
If your workspace uses different names for the contacts folder, name, phone, source or contact-link fields, list them in the assistant's instructions (see below). The Chat Link and Status field names can't be changed: add a Chat Link field and a Status field to your leads and deals folders so the link back to the conversation and the status have somewhere to go.
Guide the assistant
When a customer shares their name and phone and is interested, create a lead in NetHunt
with status "New".
When the customer agrees to buy, create a deal with status "Negotiation".
NetHunt structure: contacts folder "Clients" (name field "Full name", phone field "Mobile");
in leads and deals the contact link field is "Client".Test it
- Message the assistant on any connected channel, give a name and phone number, and ask to be contacted.
- Check your leads folder in NetHunt: a new record should appear with source
AI-<assistant name>and a Chat Link. - Check the contacts folder: the contact should exist once, linked to the lead.
Limits and requirements
- PRO plan or higher is needed to connect.
- One CRM per assistant. While NetHunt is connected, the other CRM systems are grayed out for that assistant.
- Every field you tick is required when the assistant creates a record. Tick only what it can realistically collect in a chat.
- Status values must already exist. The assistant learns valid statuses from the Status field of recent records in your leads folder. A status nobody has used yet is rejected, and the assistant is shown the valid list.
- Contacts are matched by exact phone number among recent contacts. A differently formatted number for the same person creates a second contact.
- Updates need an earlier record. The assistant updates the lead or deal it created for this customer; it doesn't search NetHunt for older records to edit.
- No pipelines and no webhooks. NetHunt has no pipeline picker in MyChatBot, and changes you make in NetHunt don't flow back automatically.
See also
- Integrations overview — the connect flow every integration shares
- Labels and statuses — how CRM statuses map to conversations
- Leads — where the mirrored status shows up in MyChatBot
