CreateConversationAsync - Gofive OpenAPI

Log a conversation against a customer.

The conversation is recorded as the user who owns the access token, unless createdByEmail
names the employee who actually had it. That employee is looked up by the address they sign
in to Venio with, within the token's own company, and must be active; an address that cannot
be resolved is rejected with 400 rather than quietly falling back to the token's user.
createdByEmail and createdByName come back on every success, named employee or not, so
one field always says who the conversation was filed under.

Fields the platform derives, and which therefore must not be sent:

action — computed from type, outcome, quantified and the customer's own state.

outcome is stored only for type Call and SMS; subType only for type Social.
Sending one where it does not apply is rejected rather than silently dropped.

quantified is required where the conversation reached the customer — a connected call, a
replied SMS, or any Email, Social or Other conversation — and rejected otherwise, because
the product records no interest level for a call nobody answered.

quantified 110052 (Not sure) is accepted only while the customer is still a Lead.

Contacts and deals are named, not numbered: pass contactName and dealNo, both resolved
within the customer named by customerCode.

Side effects: a feed timeline entry is always created; when dateFollowUp is given a
follow-up task is created and assigned to whoever the conversation was filed under — the
employee named by createdByEmail, or the token's user when none was named; when the
conversation is linked to a deal the deal's timeline is updated.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Body Params application/jsonRequired

Example

{
    "customerCode": "C000001",
    "type": 110011,
    "outcome": 110046,
    "subType": 110021,
    "quantified": 110051,
    "dateConversation": "2026-09-15T10:30:00",
    "description": "Called to follow up on the quotation",
    "contactName": "สมชาย ใจดี",
    "dealNo": "D260902988",
    "callMinutes": 12,
    "dateFollowUp": "2026-09-22T09:00:00",
    "followUpNotes": "Send the revised quotation",
    "createdByEmail": "[email protected]"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Success

Bodyapplication/json

Example

{
    "status": {
        "code": "1000",
        "description": "Success"
    },
    "data": {
        "conversationId": 987654,
        "customerCode": "C000001",
        "customerName": "Gofive Co., Ltd.",
        "type": 110011,
        "outcome": 110046,
        "subType": null,
        "subTypeName": "string",
        "quantified": 110051,
        "quantifiedName": "สนใจ",
        "action": 110061,
        "actionName": "Interested",
        "dateConversation": "2019-08-24T14:15:22.123Z",
        "contactName": "string",
        "dealNo": "string",
        "dateFollowUp": "2019-08-24T14:15:22.123Z",
        "dateCreated": "2019-08-24T14:15:22.123Z",
        "createdByEmail": "[email protected]",
        "createdByName": "สมชาย ใจดี"
    }
}

🟠400

🟠401

🟠403

🔴500