Talkative
Zoho CRM

Find Zoho CRM Contact by Email

Looks up a contact in Zoho CRM by email address.

Unverified

Add this first. This tool needs an access token, so add Get Zoho CRM Access Token to the same bot. The bot calls it first and passes the token in.

What the model is told

Look up a contact in Zoho CRM by the exact email address the customer gives you. Get an access token first if you do not have one. Returns the matching contact with its ID, name, email and phone number. If nothing is returned, no contact has that email.

Request

GEThttps://YOUR_ZOHO_API_DOMAIN/crm/v8/Contacts/search?email={{email}}&fields=id,Full_Name,Email,Phone&per_page=1

Headers

  • AuthorizationZoho-oauthtoken {{accessToken}}

Parameters

  • email stringThe customer's full email address.
  • accessToken stringThe access_token value returned by Get Zoho CRM Access Token. Reuse it for the rest of the conversation.

Engage payload

{
  "source": "VOICE_AI",
  "tool": {
    "id": "ca30052c-6cf5-4a4c-ae69-61ee471354ef",
    "type": "HTTP_REQUEST",
    "label": "Find Zoho CRM Contact by Email",
    "name": "find_zoho_crm_contact_by_email",
    "customName": false,
    "description": "Look up a contact in Zoho CRM by the exact email address the customer gives you. Get an access token first if you do not have one. Returns the matching contact with its ID, name, email and phone number. If nothing is returned, no contact has that email.",
    "parameters": [
      {
        "name": "email",
        "type": "string",
        "description": "The customer's full email address."
      },
      {
        "name": "accessToken",
        "type": "string",
        "description": "The access_token value returned by Get Zoho CRM Access Token. Reuse it for the rest of the conversation."
      }
    ],
    "config": {
      "endpoint": {
        "method": "GET",
        "url": "https://YOUR_ZOHO_API_DOMAIN/crm/v8/Contacts/search?email={{email}}&fields=id,Full_Name,Email,Phone&per_page=1"
      },
      "headers": [
        {
          "name": "Authorization",
          "value": "Zoho-oauthtoken {{accessToken}}"
        }
      ],
      "body": null,
      "timeout": null
    }
  }
}

IDs are regenerated on every copy.