Gofive OpenAPI
empeoVenio
eTaxGo
empeoVenio
eTaxGo
  1. Deal
  • Introduction
  • Activity
    • Activities Enquiry
      POST
    • Get a Activity By Id
      GET
    • Get a Activity By No
      GET
    • Get Key Activities
      GET
    • Create or Update Activity
      POST
  • Authentication API
    • Authorization
      POST
  • Customer
    • Get customer by id
      GET
    • Get customer by code
      GET
    • GetBusinessInfoByCustomerCodeAsync
      GET
    • Create or Update customer
      POST
    • Customers Enquiry
      POST
    • Create Customer Satisfaction
      POST
    • Get customers by tax number
      GET
    • Customer Search
      POST
    • Get customer by name
      GET
    • Add Customer Event
      POST
    • Get Customer Events by Customer Code
      GET
    • Get Customer Event Types
      GET
    • Edit Customer Event
      PUT
    • Delete Customer Event
      DELETE
    • Get file categories
      GET
    • Attach files category
      POST
    • Check Customer Existence
      POST
    • Get Customer by code
      GET
  • Case
    • Add Case
    • Edit Case by CaseNo
    • Get Case by CaseNo
    • Get Case Categories
  • Case Management
    • Create Or Update Case
    • Case Enquiry
    • Get Case Categories
    • Get Case Stages
    • Get Case By CaseNo
  • Contract
    • Get Contract By No
    • Get Contract Types
    • Get Contract Templates
    • Create or Update Contract
    • Create or Update Contract Service Agreement
    • Send Contract Document
  • Conversation
    • Conversation Enquiry
    • CreateConversationAsync
    • GetConversationAsync
  • Expense
    • Create Expense
    • Update Expense
    • Expense Enquiry
    • Get a Expense
  • Deal
    • Create Deal
      POST
    • Update Deal
      PUT
    • Deal Enquiry
      POST
    • Get Deal
      GET
    • Get Deal Board
      GET
    • Get Deal Stage
      GET
    • Get Deal Interest
      GET
    • Get DealLabel
      GET
    • Get Deal Missed Reason Categories
      GET
  • Employee
    • Employees Enquiry
    • Get a Employee
  • Product
    • Create Or Update Products
    • Get a Product Ticket
    • Get Products With Take & Status
    • Get a Product by ProductCode
    • Get Product Groups
    • Get Product Properties
    • Get Products By Filter
    • Verify Serial Number
    • Check Serial Verification Status
    • Create or Update Codeguard Products
    • Update Product Stock
    • Get Units
    • Get Product Reservations
    • Get Product Stocks
    • Get a Product by ProductCode (v1)
    • Products Enquiry (v1)
  • Quotation
    • Create Update Quotation
    • Quotation Enquiry
    • Get a Quotation By QuotationNo
    • Cancel Quotation
    • Get Pdf By QuotationNo
    • Convert Quotation To SalesOrder
  • SalesOrder
    • Create Or Update SalesOrder
    • SalesOrder Enquiry
    • Get a SalesOrder By Id
    • Get a SalesOrder By No
    • Get Sale Order Attachment by Id
    • Get Sale Order Attachment By No
    • Reject SaleOrder
    • Approve Sale Order
    • Update SalesOrder Payment
    • Get Pdf By SalesOrderNo
    • Update SalesOrder Tracking Number
    • Cancel SalesOrder
    • Cancel SalesOrder (v2)
    • Complete SalesOrder
    • Complete SalesOrder (v2)
  • Webhooks
    • Webhook Payload
  • Task
    • Task Enquiry
    • CompleteTaskAsync
    • CreateTask
  • Setting
    • Get HeaderTemplate
    • Get Sales Custom Fields
  • Chat
    • Post Send message
  • Storage
    • Upload files attachments
    • Get file attachments
    • Delete file attachments
  • Calendio
    • Create Venio Calendio Event
    • Edit Venio Calendio Event
    • Get Venio Calendio Events
    • Create empeo Calendio Event
    • Edit empeo Calendio Event
    • Get empeo Calendio Events
    • Get Venio Calendio Event by Id
    • Get empeo Calendio Event by Id
    • Create Appointment
    • Appointment Enquiry
    • Edit Appointment
    • Get Appointment By Id
    • Add Calendio Custom Field
    • Calendio Custom Field Enquiry
    • Get Calendio Custom Field by Id
    • Available slots Enquiry
    • Calendio Bookings Enquiry
    • Reschedule Calendio Booking time
    • Cancel Calendio Booking
  • Venio
    • SalesOrder
    • Quotation
  1. Deal

Get Deal

GET
https://api.gofive.co.th/v1/deals/{id}
ดึงข้อมูลจาก Deal โดย deals id

Deal Timeline (ใหม่ใน 7.27.3)#

ส่ง query timelineTake เพื่อให้ response มี timeline เป็นรายการเดียวกับที่หน้า Deal Detail ของ Venio แสดง เรียงจากใหม่ไปเก่า
timelineTake = 1-100 คือจำนวนรายการสูงสุดที่ต้องการ
ไม่ส่ง หรือส่ง 0 = ไม่มี timeline และ response เหมือนเดิมทุกอย่าง
ถ้าดึง timeline ไม่สำเร็จ ข้อมูลดีลยังกลับมาปกติ แต่ timeline จะเป็น array ว่าง

แต่ละรายการมีอะไร#

Fieldความหมาย
actionText / actionTextEnประโยคที่หน้าจอแสดง เช่น "แอดมิน ผูกดีลกับกิจกรรม ACTIVITY260800089 test check-in"
status / statusNameเกิดอะไรขึ้น (ดูตารางด้านล่าง)
userFullname, isSystemผู้ทำรายการ · เป็น "Venio" เมื่อระบบทำเอง
dateActionเวลาที่เกิดรายการ
refรายการที่ถูกผูก / ยกเลิกผูก: type (Activity, Conversation, Quotation, SalesOrder, Contract, Case, Expense, Task), id, no, title, amount, date · การติดต่อมี contactName, conversationType, subType (Social), outCome (Call / SMS)
dealStageNameสถานะใหม่ เฉพาะรายการเปลี่ยนสถานะ
fromBoardName / toBoardNameเฉพาะรายการย้ายบอร์ด
reason, dealCategoryNameเหตุผลและหมวดเหตุผล เมื่อพลาดดีล
assignedUsers / unassignedUsersผู้ที่ถูกเพิ่ม / เอาออก เมื่อมอบหมายใหม่

status ที่พบบ่อย#

statusstatusNameหน้าจอแสดง
1403CreateDealStateสร้างดีลใหม่
1404 / 1416EditDealState / UpdateDealStateแก้ไขดีล / ปรับข้อมูลดีล
1405UpdateStatusDealStateเปลี่ยนสถานะเป็น <dealStageName>
1406WonDealStateปิดดีลได้
1407MissDealStateพลาดดีล
1415CancelDealStateยกเลิกดีล
1408FollowUpDealStateติดตามดีล
1433MoveBoardDealStateย้ายดีลจากบอร์ด A ไปยังบอร์ด B
1047 / 1048DealReAssign / DealAssignmentParticitpantsมอบหมายใหม่ / อัปเดตผู้เกี่ยวข้อง
1412 / 1411LinkActivityDealState / UnlinkActivityDealStateผูก / ยกเลิกผูก กิจกรรม
1035 / 1036ActivityWithDeal / UnlinkActivityDealผูก / ยกเลิกผูก กิจกรรม (บันทึกจากฝั่งกิจกรรม)
1414 / 1413LinkConversationDeal / UnlinkConversationDealผูก / ยกเลิกผูก การติดต่อ
1402 / 1401LinkQuotationDealState / Unlinkquotationdealstateผูก / ยกเลิกผูก ใบเสนอราคา
1410 / 1409LinkSaleOrderDealState / UnlinkSaleOrderDealStateผูก / ยกเลิกผูก ใบสั่งขาย
1651 / 1652LinkContractDeal / UnlinkDealผูก / ยกเลิกผูก สัญญา
1438 / 1437LinkCaseDealState / UnlinkCaseDealStateผูก / ยกเลิกผูก เคส
1431 / 1434LinkTaskDealState / UnlinkTaskDealผูก / ยกเลิกผูก งาน
status อื่นที่ไม่อยู่ในตารางยังคืนมาตามปกติ โดย actionText จะใช้ข้อความเดียวกับหน้าจอ

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Path Params

Query Params

Header Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.gofive.co.th/v1/deals/?timelineTake=undefined' \
--header 'Ocp-Apim-Subscription-Key: <Your-Subscription-Key>' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json'

Responses

🟢200OK
application/json
Bodyapplication/json

Example
{
    "data": {
        "value": {
            "dealsId": 1,
            "customerId": 1,
            "dealNo": "string",
            "dealsName": "string",
            "dealsValue": 2,
            "statusId": 703,
            "dealsIndex": 4,
            "dealsDate": "2022-03-28T16:50:15+0700",
            "expectedCloseDate": "2022-03-28T16:50:15+0700",
            "effectiveDate": "2022-03-28T16:50:15+0700",
            "closeDate": "2022-03-28T16:50:15+0700",
            "calTargetDate": "2022-03-28T16:50:15+0700",
            "probability": 99,
            "notes": "string",
            "isActive": true,
            "boardId": 1,
            "dateCreated": "2022-03-28T16:51:25+0700",
            "createByUserId": "string",
            "dateModified": "2022-09-09T11:10:18+0700",
            "modifiedByUserId": "string",
            "measure": 3,
            "lastDealStateId": 1,
            "valueCalculationType": 1,
            "customer": {
                "customerId": 1,
                "companyId": 1,
                "customerCode": "string",
                "customerName": "string",
                "customerNameEN": "string",
                "type": 13002,
                "customerType": 11300,
                "branch": "string",
                "phone": "string",
                "mobile": "",
                "notes": "",
                "isActive": true,
                "dateChangeToCustomer": "2021-12-20T15:49:49+0700",
                "createdByUserId": "string",
                "dateCreated": "2020-08-19T16:59:42+0700",
                "modifiedByUserId": "string",
                "dateModified": "2022-09-09T11:09:18+0700",
                "customerGroupId": 1,
                "leadStatus": 110064,
                "hasPicture": true,
                "companyName": "",
                "sourceOfLead": 110090,
                "classificationId": 20,
                "customerStateId": 200008,
                "hasOwner": true,
                "pictureUrl": "string",
                "addresses": [],
                "customerInterests": []
            },
            "dealsInterests": [],
            "dealsLabels": [],
            "isEdit": true,
            "isDelete": true,
            "statusName": "string",
            "user": {
                "preferences": {},
                "userId": "string",
                "username": "string",
                "companyId": 1,
                "companyName": "string",
                "teamId": 1,
                "teamName": "string",
                "staffCode": "string",
                "title": "",
                "firstname": "string",
                "lastname": "string",
                "fullname": "string",
                "position": "string",
                "email": "string",
                "phoneNumber": "string",
                "orgString": "string",
                "orgLevel": 1,
                "latitude": 1,
                "longitude": 1,
                "location": "string",
                "locationName": "string",
                "isActive": true,
                "createdByUserId": "string",
                "hasPicture": true,
                "dateCreated": "2018-11-05T10:13:59+0700",
                "dateModified": "2023-01-19T12:02:48+0700",
                "role": "string",
                "roleId": "string",
                "level": 0,
                "siteId": 1,
                "isAgreementPDPA": true,
                "dateAgreementPDPA": "2020-08-26T07:13:22+0700",
                "emailSubscription": 1,
                "identityUserId": "string",
                "uniqueName": "string",
                "inAppSubscription": 1,
                "userType": 1011
            },
            "dealSummary": {
                "probability": 99,
                "dealValue": 2,
                "expectedCloseDate": "2022-03-28T16:50:15+0700"
            },
            "aiSummary": {
                "probability": 60,
                "expectedCloseDate": "2027-02-15T00:00:00+0700",
                "dateAnalyzed": "2026-03-23T17:07:55+0700",
                "dateManualProbability": null,
                "probabilityTextTh": "ความน่าจะเป็นชนะ: 60% (ระดับปานกลาง). เหตุผล: เป็นการต่ออายุของลูกค้ารายเดิม แต่ยังไม่ได้รับ feedback การใช้งาน",
                "probabilityTextEn": "Win Probability: 60% (Moderate). Reason: incumbent renewal, but no usage feedback has been collected yet",
                "expectedCloseDateTextTh": "คาดว่าจะปิดภายในวันที่ 15/02/2027 เพราะสัญญาปัจจุบันหมดอายุเดือนมีนาคม 2027",
                "expectedCloseDateTextEn": "Expected close: 2027-02-15 because the current contract expires in March 2027",
                "keyInfluencingFactorsTh": "1) สัญญาหมดอายุ มี.ค. 2027 ทำให้มีกรอบเวลาชัดเจน 2) ยังไม่มี feedback การใช้งานจากผู้ใช้หลัก",
                "keyInfluencingFactorsEn": "1) Contract expiry in March 2027 sets a clear renewal window 2) No usage feedback from key users yet",
                "actionableRecommendationsTh": "- นัดประชุมต่ออายุภายใน 7 วัน\n- ส่งใบเสนอราคาต่ออายุพร้อมทางเลือกแพ็กเกจ",
                "actionableRecommendationsEn": "- Book a renewal meeting within 7 days\n- Send a renewal quotation with package options",
                "positiveFactorsTh": [
                    "เป็นลูกค้าเดิม",
                    "มีกิจกรรม Health Check ในแผน"
                ],
                "positiveFactorsEn": [
                    "Existing customer",
                    "Health Check activity is planned"
                ],
                "riskFactorsTh": [
                    "สายล่าสุดลูกค้าไม่รับ"
                ],
                "riskFactorsEn": [
                    "The last call was not answered"
                ],
                "coaching": {
                    "radarTime": 0,
                    "radarProgress": 57.14,
                    "radarMomentum": null,
                    "radarHealth": 0,
                    "radarTier": 1,
                    "radarColor": "red",
                    "titleTh": "สายล่าสุดไม่รับ ต่ออายุนี้ต้องดึงกลับ",
                    "titleEn": "Last call missed, pull this renewal back",
                    "coachingMessageTh": "ดีลต่ออายุนี้มีฐานจากการเป็นลูกค้าเดิม แต่คอขวดคือยังไม่มี feedback การใช้งาน ควรติดต่อผู้ใช้หลักก่อนส่งใบเสนอราคา",
                    "coachingMessageEn": "This renewal starts from an existing relationship, but the bottleneck is missing usage feedback. Reach the key users before sending the quotation.",
                    "nextActionsTh": [
                        "โทรหาผู้ใช้หลักเพื่อขอ feedback การใช้งาน",
                        "นัดประชุมต่ออายุพร้อมสรุปผลการใช้งาน"
                    ],
                    "nextActionsEn": [
                        "Call the key users to collect usage feedback",
                        "Book a renewal meeting with a usage summary"
                    ],
                    "source": "deal_prob",
                    "dateCalculated": "2026-09-24T18:03:32+0700"
                }
            },
            "measureUnit": {
                "unitId": 3,
                "name": "ด้าม",
                "companyId": 1,
                "isActive": true,
                "createdByUserId": "string",
                "dateCreated": "2019-12-11T11:09:01+0700",
                "modifiedByUserId": "string",
                "dateModified": "2019-12-11T11:09:01+0700"
            },
            "timeline": [
                {
                    "status": 1405,
                    "statusName": "UpdateStatusDealState",
                    "logType": 270007,
                    "logTypeName": "Deal",
                    "actionText": "แอดมิน ยูเอที เปลี่ยนสถานะเป็น Negotiation",
                    "actionTextEn": "แอดมิน ยูเอที Update stage to Negotiation",
                    "id": 99400,
                    "dealsStateId": 512800,
                    "userId": "string",
                    "userFullname": "แอดมิน ยูเอที",
                    "isSystem": false,
                    "dateAction": "2026-09-08T09:00:00+0700",
                    "comment": null,
                    "reason": null,
                    "dealStageName": "Negotiation",
                    "dealCategoryName": null,
                    "dateFollowUp": null,
                    "fromBoardName": null,
                    "toBoardName": null,
                    "ref": null,
                    "assignedUsers": null,
                    "unassignedUsers": null
                },
                {
                    "status": 1414,
                    "statusName": "LinkConversationDeal",
                    "logType": 270007,
                    "logTypeName": "Deal",
                    "actionText": "แอดมิน ยูเอที ผูกดีลกับการติดต่อ โทรศัพท์: ติดต่อได้ (Bibi)",
                    "actionTextEn": "แอดมิน ยูเอที Linked deal with conversation Call: Connected (Bibi)",
                    "id": 99400,
                    "dealsStateId": 512790,
                    "userId": "string",
                    "userFullname": "แอดมิน ยูเอที",
                    "isSystem": false,
                    "dateAction": "2026-09-07T10:10:00+0700",
                    "comment": null,
                    "reason": null,
                    "dealStageName": null,
                    "dealCategoryName": null,
                    "dateFollowUp": null,
                    "fromBoardName": null,
                    "toBoardName": null,
                    "ref": {
                        "type": "Conversation",
                        "id": 245957,
                        "no": null,
                        "title": null,
                        "statusId": null,
                        "statusName": null,
                        "amount": null,
                        "currencySymbol": null,
                        "date": "2026-08-07T11:19:03+0700",
                        "dateEnd": null,
                        "contactName": "Bibi",
                        "conversationType": 110011,
                        "conversationTypeName": "Call",
                        "subType": null,
                        "subTypeName": null,
                        "outCome": 110046,
                        "outComeName": "Connected",
                        "qualification": 110053,
                        "qualificationName": "Interested"
                    },
                    "assignedUsers": null,
                    "unassignedUsers": null
                },
                {
                    "status": 1412,
                    "statusName": "LinkActivityDealState",
                    "logType": 270007,
                    "logTypeName": "Deal",
                    "actionText": "แอดมิน ยูเอที ผูกดีลกับกิจกรรม ACTIVITY260800089 test check-in",
                    "actionTextEn": "แอดมิน ยูเอที Linked deal with activity ACTIVITY260800089 test check-in",
                    "id": 99400,
                    "dealsStateId": 427979,
                    "userId": "string",
                    "userFullname": "แอดมิน ยูเอที",
                    "isSystem": false,
                    "dateAction": "2026-08-29T22:11:00+0700",
                    "comment": "test checkin",
                    "reason": null,
                    "dealStageName": null,
                    "dealCategoryName": null,
                    "dateFollowUp": null,
                    "fromBoardName": null,
                    "toBoardName": null,
                    "ref": {
                        "type": "Activity",
                        "id": 925630,
                        "no": "ACTIVITY260800089",
                        "title": "test check-in",
                        "statusId": null,
                        "statusName": null,
                        "amount": null,
                        "currencySymbol": null,
                        "date": "2026-08-30T10:00:00+0700",
                        "dateEnd": "2026-08-30T11:00:00+0700",
                        "conversationType": null,
                        "conversationTypeName": null,
                        "subType": null,
                        "subTypeName": null,
                        "outCome": null,
                        "outComeName": null,
                        "qualification": null,
                        "qualificationName": null,
                        "contactName": null
                    },
                    "assignedUsers": null,
                    "unassignedUsers": null
                },
                {
                    "status": 1407,
                    "statusName": "MissDealState",
                    "logType": 270007,
                    "logTypeName": "Deal",
                    "actionText": "Venio พลาดดีล (Price)",
                    "actionTextEn": "Venio Miss deal (Price)",
                    "id": 99400,
                    "dealsStateId": 512802,
                    "userId": "string",
                    "userFullname": "Venio",
                    "isSystem": true,
                    "dateAction": "2026-08-20T09:00:00+0700",
                    "comment": null,
                    "reason": "ราคาสูงไป",
                    "dealStageName": null,
                    "dealCategoryName": "Price",
                    "dateFollowUp": null,
                    "fromBoardName": null,
                    "toBoardName": null,
                    "ref": null,
                    "assignedUsers": null,
                    "unassignedUsers": null
                }
            ]
        },
        "statusCode": 200
    },
    "statusCode": 1000,
    "httpStatusCode": 200
}
🟠401Unauthorized
🟠403Forbidden
Modified at 2026-10-02 10:22:18
Previous
Deal Enquiry
Next
Get Deal Board
Built with