Jump to

• Request
• Response

Get facts about recommended contacts for a lead or opportunity

get

/crmRestApi/crmSalesIntelligenceApi/11.13.18.05/facts/contactRecommendation

This method is used to get the record level facts about the recommended contacts for a lead or opportunity.

Request

Query Parameters

• q: string
  To identify: A CRM object record by ObjectType and ObjectId values. Example: ObjectType=opportunity;ObjectId=999999999

There's no request body for this operation.

Security

• BasicAuthentication: http
  Type: http

Back to Top

Response

Supported Media Types

• application/json

200 Response

OK

Headers

• Server-Time-In-Millis:
  The server time comnsumed by the API to complete execution.

Body ()

Root Schema : ContactRecommendationFacts

Type: object

Title: ContactRecommendationFacts

The contactRecommendation API response.

Show Source

• count: integer
  The count of items in current response.
• hasMore: boolean
  A boolean flag which indicates the availability of more matching records at server.
• items: array items
  The contact recommendation facts array.
• limit: integer
  The limit applied to the query.
• links: array links
  The links.
• offset: integer
  The offset applied to the query.

{
    "title":"ContactRecommendationFacts",
    "type":"object",
    "properties":{
        "items":{
            "type":"array",
            "description":"The contact recommendation facts array.",
            "items":{
                "$ref":"#/components/schemas/ContactRecommendationFactItems"
            }
        },
        "offset":{
            "type":"integer",
            "description":"The offset applied to the query."
        },
        "limit":{
            "type":"integer",
            "description":"The limit applied to the query."
        },
        "hasMore":{
            "type":"boolean",
            "description":"A boolean flag which indicates the availability of more matching records at server."
        },
        "count":{
            "type":"integer",
            "description":"The count of items in current response."
        },
        "links":{
            "type":"array",
            "description":"The links.",
            "items":{
                "$ref":"#/components/schemas/Link"
            }
        }
    },
    "description":"The contactRecommendation API response."
}

Nested Schema : items

Type: array

The contact recommendation facts array.

Show Source

• Array of: object ContactRecommendationFactItems
  Title: ContactRecommendationFactItems

  The facts about thecontact recommendation of a record generated using the object and record level metrics.

{
    "type":"array",
    "description":"The contact recommendation facts array.",
    "items":{
        "$ref":"#/components/schemas/ContactRecommendationFactItems"
    }
}

Nested Schema : links

Type: array

The links.

Show Source

• Array of: object Link
  Title: Link

  The link item.

{
    "type":"array",
    "description":"The links.",
    "items":{
        "$ref":"#/components/schemas/Link"
    }
}

Nested Schema : ContactRecommendationFactItems

Type: object

Title: ContactRecommendationFactItems

The facts about thecontact recommendation of a record generated using the object and record level metrics.

Show Source

• CreatedBy: string
  Indicates the user who created the row.
• CreationDate: string (date-time)
  Indicates the date and time of the creation of the row.
• ExplanationText: string
  The explanation for the record classification .
• InsightFactId: integer
  The auto-generated unique identifier for an insight fact.
• InsightTemplateUuid: string (uuid)
  The auto-generated unique Identifier for an insight template
• InsightTypeCode: string
  A unique code assigned to an insight template.
• LastUpdateDate: string (date-time)
  Indicates the date and time of the last update of the row.
• LastUpdatedBy: string
  Indicates the user who last updated the row.
• LastUpdateLogin: string
  Indicates the session login associated to the user who last updated the row.
• ObjectId: integer
  The PK attribute value of the CRM record
• ObjectType: string
  The object type name of the CRM entity.
• RecordClassification: string
  The classification text of the record based on the facts generated.
• RecordClassificationCode: string
  The classification code of the record based on the facts generated.
• RecordFacts: array RecordFacts
  The record level facts generated by comparing record query result against object metrics.

{
    "title":"ContactRecommendationFactItems",
    "type":"object",
    "properties":{
        "InsightFactId":{
            "type":"integer",
            "description":"The auto-generated unique identifier for an insight fact."
        },
        "InsightTypeCode":{
            "type":"string",
            "description":"A unique code assigned to an insight template."
        },
        "LastUpdatedBy":{
            "type":"string",
            "description":"Indicates the user who last updated the row."
        },
        "LastUpdateLogin":{
            "type":"string",
            "description":"Indicates the session login associated to the user who last updated the row."
        },
        "InsightTemplateUuid":{
            "type":"string",
            "description":"The auto-generated unique Identifier for an insight template",
            "format":"uuid"
        },
        "CreationDate":{
            "type":"string",
            "description":"Indicates the date and time of the creation of the row.",
            "format":"date-time"
        },
        "RecordClassificationCode":{
            "type":"string",
            "description":"The classification code of the record based on the facts generated."
        },
        "RecordClassification":{
            "type":"string",
            "description":"The classification text of the record based on the facts generated."
        },
        "LastUpdateDate":{
            "type":"string",
            "description":"Indicates the date and time of the last update of the row.",
            "format":"date-time"
        },
        "ExplanationText":{
            "type":"string",
            "description":"The explanation for the record classification ."
        },
        "CreatedBy":{
            "type":"string",
            "description":"Indicates the user who created the row."
        },
        "RecordFacts":{
            "type":"array",
            "description":"The record level facts generated by comparing record query result against object metrics.",
            "items":{
                "$ref":"#/components/schemas/ContactRecommendationFact"
            }
        },
        "ObjectId":{
            "type":"integer",
            "description":"The PK attribute value of the CRM record"
        },
        "ObjectType":{
            "type":"string",
            "description":"The object type name of the CRM entity."
        }
    },
    "description":"The facts about thecontact recommendation of a record generated using the object and record level metrics."
}

Nested Schema : RecordFacts

Type: array

The record level facts generated by comparing record query result against object metrics.

Show Source

• Array of: object ContactRecommendationFact
  Title: ContactRecommendationFact

  The fact data about the contact recommendation.

{
    "type":"array",
    "description":"The record level facts generated by comparing record query result against object metrics.",
    "items":{
        "$ref":"#/components/schemas/ContactRecommendationFact"
    }
}

Nested Schema : ContactRecommendationFact

Type: object

Title: ContactRecommendationFact

The fact data about the contact recommendation.

Show Source

• InsightSubTypeCode: string
  The insight sub type code.
• items: array items
  The list of recommended contacts.

{
    "title":"ContactRecommendationFact",
    "type":"object",
    "properties":{
        "InsightSubTypeCode":{
            "type":"string",
            "description":"The insight sub type code."
        },
        "items":{
            "type":"array",
            "description":"The list of recommended contacts.",
            "items":{
                "$ref":"#/components/schemas/ContactRecommendationList"
            }
        }
    },
    "description":"The fact data about the contact recommendation."
}

Nested Schema : items

Type: array

The list of recommended contacts.

Show Source

• Array of: object ContactRecommendationList
  Title: ContactRecommendationList

  The list of recommended contacts.

{
    "type":"array",
    "description":"The list of recommended contacts.",
    "items":{
        "$ref":"#/components/schemas/ContactRecommendationList"
    }
}

Nested Schema : ContactRecommendationList

Type: object

Title: ContactRecommendationList

The list of recommended contacts.

Show Source

• ContactId: string
  The id of the recommended contact.
• ContactName: string
  The name of the recommended contact.
• JobTitle: string
  The job title of the recommended contact.
• Rank: string
  The rank of the recommended contact.
• RankCategory: string
  The category in which this contact is recommended.

{
    "title":"ContactRecommendationList",
    "type":"object",
    "properties":{
        "Rank":{
            "type":"string",
            "description":"The rank of the recommended contact."
        },
        "ContactName":{
            "type":"string",
            "description":"The name of the recommended contact."
        },
        "RankCategory":{
            "type":"string",
            "description":"The category in which this contact is recommended."
        },
        "ContactId":{
            "type":"string",
            "description":"The id of the recommended contact."
        },
        "JobTitle":{
            "type":"string",
            "description":"The job title of the recommended contact."
        }
    },
    "description":"The list of recommended contacts."
}

Nested Schema : Link

Type: object

Title: Link

The link item.

Show Source

• href: string
  The link href.
• kind: string
  The link kind.
• name: string
  The link name.
• rel: string
  The link relation.

{
    "title":"Link",
    "type":"object",
    "properties":{
        "name":{
            "type":"string",
            "description":"The link name."
        },
        "kind":{
            "type":"string",
            "description":"The link kind."
        },
        "href":{
            "type":"string",
            "description":"The link href."
        },
        "rel":{
            "type":"string",
            "description":"The link relation."
        }
    },
    "description":"The link item."
}

400 Response

Bad Request

401 Response

Unauthorized

404 Response

Not Found

405 Response

Method Not Allowed

500 Response

Internal Server Error

Back to Top