> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Gong Add Digital Interaction: Inputs, Cost & CLI Example
> Post a Digital Interaction (/v2/digital-interaction). Includes inputs, outputs, pricing notes, Deepline CLI examples, and GTM automation guidance.
## Run in Enrichment Spreadsheet
Use this function as a column step in `deepline enrich`.
```bash theme={null}
deepline enrich --input leads.csv --output leads.enriched.csv --with 'result=gong_add_digital_interaction:{"eventId":"{{eventId}}","timestamp":"{{timestamp}}","eventType":"{{eventType}}","content":{}}' --json
```
Map payload values to spreadsheet columns with `{{column_name}}` placeholders.
## Input Schema
| Name | Type | Required | Default | Description |
| -------------------------- | ------------------ | -------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `payload.eventId` | `string` | Yes | | The provider's unique identifier for the event used for deduplication |
| `payload.timestamp` | `string` | Yes | | The date and time of the event in ISO 8601 format |
| `payload.eventType` | `string` | Yes | | The type of the event, explaining the content and action performed. Values may be partner-aligned, for example, "link clicked", "page viewed" |
| `payload.sourceSystemName` | `string` | No | | When integrating via IPaaS, the name of the technology partner the customer set up a Gong integration with via an IPaaS. When integrating directly with Gong: the name of the company setting up the integration with Gong |
| `payload.sessionId` | `string` | No | | The identifier for the session, useful for tying related events together |
| `payload.device` | `"MOBILE" \| "PC"` | No | | The device used during the event |
| `payload.content` | `object` | Yes | | The content the person looked at |
| `payload.person` | `object` | No | | The person who did the event. Must be null if a tracking ID is sent instead. |
| `payload.customFields` | `array` | No | | Include additional custom data about the event |
| `payload.trackingId` | `string` | No | | The ID used for tracking the person who did the event. Must be null if a person is sent instead. |
### Allowed values
| Field | Allowed values |
| ---------------- | -------------- |
| `payload.device` | `MOBILE`, `PC` |
Show raw input schema
### Input JSON Schema
```json theme={null}
{
"type": "object",
"description": "Digital interaction metadata",
"properties": {
"eventId": {
"type": "string",
"description": "The provider's unique identifier for the event used for deduplication"
},
"timestamp": {
"type": "string",
"description": "The date and time of the event in ISO 8601 format",
"format": "date-time"
},
"eventType": {
"type": "string",
"description": "The type of the event, explaining the content and action performed. Values may be partner-aligned, for example, \"link clicked\", \"page viewed\""
},
"sourceSystemName": {
"type": "string",
"description": "When integrating via IPaaS, the name of the technology partner the customer set up a Gong integration with via an IPaaS. When integrating directly with Gong: the name of the company setting up the integration with Gong"
},
"sessionId": {
"type": "string",
"description": "The identifier for the session, useful for tying related events together"
},
"device": {
"type": "string",
"description": "The device used during the event",
"enum": [
"MOBILE",
"PC"
]
},
"content": {
"type": "object",
"description": "The content the person looked at",
"properties": {
"contentId": {
"type": "string",
"description": "A unique identifier for the content in the partner's system"
},
"contentTitle": {
"type": "string",
"description": "The title of the content"
},
"contentLabel": {
"type": "array",
"description": "A list of tags defined for the content",
"items": {
"type": "string",
"description": "A list of tags defined for the content"
}
},
"contentUrl": {
"type": "string",
"description": "The URL for the content the person looked at"
},
"contentAdditionalInfoUrl": {
"type": "string",
"description": "The URL for additional details provided by the website or external app, such as analysis of the content viewed"
},
"numericContentDetails": {
"type": "object",
"description": "For content where there is a numeric result, such as NPS score, or metrics such as the percentage of video watched",
"properties": {
"value": {
"type": "integer",
"description": "The numeric value for the content",
"format": "int32"
},
"rangeFrom": {
"type": "integer",
"description": "The lowest value that can be given to the content",
"format": "int32"
},
"rangeTo": {
"type": "integer",
"description": "The highest value that can be given to the content",
"format": "int32"
},
"numericType": {
"type": "string",
"description": "The type of numeric value",
"enum": [
"PERCENTAGE",
"NPS",
"RATING",
"OTHER"
]
}
},
"required": [
"rangeFrom",
"rangeTo"
],
"additionalProperties": false
},
"stepContentDetails": {
"type": "object",
"description": "For content where there are a number of steps to complete in the content, such as shipment tracking or course advancement",
"properties": {
"value": {
"type": "string",
"description": "The current step the person is in, in the process"
},
"availableSteps": {
"type": "array",
"description": "A list of all available steps in the process",
"items": {
"type": "string",
"description": "A list of all available steps in the process"
}
}
},
"required": [
"availableSteps",
"value"
],
"additionalProperties": false
},
"searchObjectDetails": {
"type": "object",
"description": "The objects returned when searching for different content. For example, the companies or products being compared with one another, or 2nd party intent",
"properties": {
"name": {
"type": "string",
"description": "The name of the entity the person searched for"
},
"objectType": {
"type": "string",
"description": "The type of the entity the person searched for",
"enum": [
"VENDOR",
"PRODUCT",
"CATEGORY"
]
},
"domain": {
"type": "string",
"description": "The domain of the entity"
},
"objectId": {
"type": "string",
"description": "The ID of the entity in the partner system"
},
"url": {
"type": "string",
"description": "The URL of the entity in the partner system"
}
},
"required": [
"domain",
"name",
"objectType"
],
"additionalProperties": false
},
"contentCustomFields": {
"type": "array",
"description": "Include additional custom data about the content",
"items": {
"type": "object",
"description": "Include additional custom data about the event",
"properties": {
"name": {
"type": "string",
"description": "The name of the custom field"
},
"value": {
"type": "string",
"description": "The value of the custom field"
},
"dataType": {
"type": "string",
"description": "The data type of the custom field: NUMBER, STRING, DATE (ISO 8601), URL, DURATION (in Seconds). Default value: STRING",
"enum": [
"STRING",
"NUMBER",
"DATE",
"URL",
"BOOLEAN",
"DURATION"
]
}
},
"required": [
"name",
"value"
],
"additionalProperties": false
}
}
},
"required": [
"contentTitle"
],
"additionalProperties": false
},
"person": {
"type": "object",
"description": "The person who did the event. Must be null if a tracking ID is sent instead.",
"properties": {
"name": {
"type": "string",
"description": "The name of the person"
},
"email": {
"type": "string",
"description": "The email address of the person. Used for business context association"
},
"phoneNumber": {
"type": "string",
"description": "The phone number of the person. Used for business context association"
},
"personId": {
"type": "string",
"description": "A unique person identifier in the partner system. Mandatory for anonymous person, when the name, email, phoneNumber and personBusinessContext are empty"
},
"personBusinessContext": {
"type": "object",
"description": "The person's details in an external system such as the CRM",
"properties": {
"objectType": {
"type": "string",
"description": "The object type in the external system",
"enum": [
"CONTACT",
"LEAD"
]
},
"objectId": {
"type": "string",
"description": "The ID of the object in the external system"
},
"systemName": {
"type": "string",
"description": "The name of the external system"
}
},
"required": [
"objectId",
"objectType"
],
"additionalProperties": false
},
"location": {
"type": "object",
"description": "The location of the person as identified in the partner's source system",
"properties": {
"country": {
"type": "string",
"description": "The country of the person in ISO 3166. If not available in ISO 3166, then send as string"
},
"state": {
"type": "string",
"description": "The state of the person in ISO 3166-2. If not available in ISO 3166-2, then send as string"
},
"region": {
"type": "string",
"description": "The region of the person in ISO 3166-2. If not available in ISO 3166-2, then send as string"
},
"city": {
"type": "string",
"description": "The city of the person"
}
},
"additionalProperties": false
},
"company": {
"type": "object",
"description": "The company the person works in. Should include at least one of the following: domain, crmAccountId, crmOpportunityId (via the companyBusinessContext object)",
"properties": {
"companyId": {
"type": "string",
"description": "The company ID in the partner's source system"
},
"name": {
"type": "string",
"description": "The name of the company"
},
"domain": {
"type": "string",
"description": "The domain of the person's company. Used to associate the person with the company (\"acme.com\"). Mandatory for anonymous person, when the name, email, phoneNumber and personBusinessContext are empty"
},
"companyBusinessContexts": {
"type": "array",
"description": "The company's details in an external system such as the CRM. If the domain is empty, to enable association, send the crmAccountId or crmOpportunityId",
"items": {
"type": "object",
"description": "The company's details in an external system such as the CRM. If the domain is empty, to enable association, send the crmAccountId or crmOpportunityId",
"properties": {
"objectType": {
"type": "string",
"description": "The object type in the external system",
"enum": [
"ACCOUNT",
"OPPORTUNITY"
]
},
"objectId": {
"type": "string",
"description": "The ID of the business context object"
},
"systemName": {
"type": "string",
"description": "The name of the external system"
}
},
"required": [
"objectId",
"objectType"
],
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"personCustomFields": {
"type": "array",
"description": "Include additional custom data about the person",
"items": {
"type": "object",
"description": "Include additional custom data about the event",
"properties": {
"name": {
"type": "string",
"description": "The name of the custom field"
},
"value": {
"type": "string",
"description": "The value of the custom field"
},
"dataType": {
"type": "string",
"description": "The data type of the custom field: NUMBER, STRING, DATE (ISO 8601), URL, DURATION (in Seconds). Default value: STRING",
"enum": [
"STRING",
"NUMBER",
"DATE",
"URL",
"BOOLEAN",
"DURATION"
]
}
},
"required": [
"name",
"value"
],
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"customFields": {
"type": "array",
"description": "Include additional custom data about the event",
"items": {
"type": "object",
"description": "Include additional custom data about the event",
"properties": {
"name": {
"type": "string",
"description": "The name of the custom field"
},
"value": {
"type": "string",
"description": "The value of the custom field"
},
"dataType": {
"type": "string",
"description": "The data type of the custom field: NUMBER, STRING, DATE (ISO 8601), URL, DURATION (in Seconds). Default value: STRING",
"enum": [
"STRING",
"NUMBER",
"DATE",
"URL",
"BOOLEAN",
"DURATION"
]
}
},
"required": [
"name",
"value"
],
"additionalProperties": false
}
},
"trackingId": {
"type": "string",
"description": "The ID used for tracking the person who did the event. Must be null if a person is sent instead."
}
},
"required": [
"content",
"eventId",
"eventType",
"timestamp"
],
"additionalProperties": false
}
```
## Output Schema
| Name | Type | Required | Default | Description |
| ------------- | -------- | -------- | ------- | ---------------------------------------------- |
| `result.data` | `object` | Yes | | Provider response payload. |
| `result.meta` | `object` | No | | Additional response metadata (status, paging). |
Show raw output schema
### Output JSON Schema
```json theme={null}
{
"type": "object",
"description": "Standard tool result payload.",
"properties": {
"data": {
"type": "object",
"description": "Provider response payload.",
"properties": {
"requestId": {
"type": "string",
"description": "A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes."
}
},
"additionalProperties": false
},
"meta": {
"type": "object",
"description": "Additional response metadata (status, paging).",
"additionalProperties": true
}
},
"required": [
"data"
],
"additionalProperties": false
}
```
## Advanced: Direct CLI
Use direct execution for single payload debugging.
```bash theme={null}
deepline tools execute gong_add_digital_interaction --payload '{
"eventId": "string",
"timestamp": "string",
"eventType": "string",
"content": {}
}' --json
```
### CLI flags
| Flag | Description |
| --------------------------- | --------------------------------------------------- |
| `--json` | Print machine-readable output. |
| `--wait` | Wait for terminal provider status when supported. |
| `--debug` | Enable wait mode with additional status/log output. |
| `--wait-timeout SECONDS` | Max seconds to wait in wait mode. |
| `--poll-interval SECONDS` | Polling interval in seconds during wait mode. |
| `--timeout SECONDS` | Request timeout in seconds. |
| `--connect-timeout SECONDS` | Connection timeout in seconds. |
## Cost
* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.
* Billing mode: `no_bill`.