---

កន្លែងផ្ទុកទូរស័ព្ទអនុញ្ញាតឱ្យអ្នករក្សាទុកលេខទូរស័ព្ទនៅក្នុងកំណត់ត្រាជាមួយនឹងការផ្ទៀងផ្ទាត់ក្នុងខ្លួន និងទ្រង់ទ្រាយអន្តរជាតិ។ ពួកវាជាជម្រើសល្អសម្រាប់តាមដានព័ត៌មានទំនាក់ទំនង, ទំនាក់ទំនងបន្ទាន់, ឬទិន្នន័យដែលពាក់ព័ន្ធនឹងទូរស័ព្ទនៅក្នុងគម្រោងរបស់អ្នក។

ឧទាហរណ៍មូលដ្ឋាន

បង្កើតកន្លែងទូរស័ព្ទសាមញ្ញ:

mutation CreatePhoneField {
  createCustomField(input: {
    name: "Contact Phone"
    type: PHONE
  }) {
    id
    name
    type
  }
}

ឧទាហរណ៍កម្រិតខ្ពស់

បង្កើតកន្លែងទូរស័ព្ទដែលមានការពិពណ៌នា:

mutation CreateDetailedPhoneField {
  createCustomField(input: {
    name: "Emergency Contact"
    type: PHONE
    description: "Emergency contact number with country code"
  }) {
    id
    name
    type
    description
  }
}

ប៉ារ៉ាម៉ែត្រ​ចូល

CreateCustomFieldInput

ប៉ារ៉ាម៉ែត្រ	ប្រភេទ	ត្រូវការទេ	ការពិពណ៌នា
name	String!	✅ បាទ	ឈ្មោះបង្ហាញនៃកន្លែងទូរស័ព្ទ
type	CustomFieldType!	✅ បាទ	ត្រូវតែជា PHONE
description	String	មិន	អត្ថបទជំនួយដែលបង្ហាញទៅអ្នកប្រើ

ចំណាំ: កន្លែងផ្ទុកត្រូវបានភ្ជាប់ដោយស្វ័យប្រវត្តិជាមួយគម្រោងដោយផ្អែកលើបរិបទគម្រោងបច្ចុប្បន្នរបស់អ្នកប្រើ។ មិនត្រូវការប៉ារ៉ាម៉ែត្រ projectId ទេ។

ការកំណត់តម្លៃទូរស័ព្ទ

ដើម្បីកំណត់ ឬធ្វើអាប់ដេតតម្លៃទូរស័ព្ទនៅលើកំណត់ត្រា:

mutation SetPhoneValue {
  setTodoCustomField(input: {
    todoId: "todo_123"
    customFieldId: "field_456"
    text: "+1 234 567 8900"
  })
}

SetTodoCustomFieldInput ប៉ារ៉ាម៉ែត្រ

ប៉ារ៉ាម៉ែត្រ	ប្រភេទ	ត្រូវការទេ	ការពិពណ៌នា
todoId	String!	✅ បាទ	ID នៃកំណត់ត្រាដើម្បីធ្វើអាប់ដេត
customFieldId	String!	✅ បាទ	ID នៃកន្លែងផ្ទុកទូរស័ព្ទ
text	String	មិន	លេខទូរស័ព្ទដែលមានកូដប្រទេស
regionCode	String	មិន	កូដប្រទេស (ត្រូវបានរកឃើញដោយស្វ័យប្រវត្តិ)

ចំណាំ: ខណៈពេលដែល text គឺជាជម្រើសនៅក្នុងស្ដង់ដារ, លេខទូរស័ព្ទត្រូវបានទាមទារសម្រាប់កន្លែងដើម្បីមានអត្ថន័យ។ នៅពេលប្រើ setTodoCustomField, មិនមានការផ្ទៀងផ្ទាត់ត្រូវបានអនុវត្ត - អ្នកអាចរក្សាទុកតម្លៃអត្ថបទណាមួយ និង regionCode។ ការរកឃើញដោយស្វ័យប្រវត្តិគ្រាន់តែកើតឡើងនៅពេលបង្កើតកំណត់ត្រា។

ការបង្កើតកំណត់ត្រាជាមួយតម្លៃទូរស័ព្ទ

នៅពេលបង្កើតកំណត់ត្រាថ្មីជាមួយតម្លៃទូរស័ព្ទ:

mutation CreateRecordWithPhone {
  createTodo(input: {
    title: "Call client"
    todoListId: "list_123"
    customFields: [{
      customFieldId: "phone_field_id"
      value: "+1-555-123-4567"
    }]
  }) {
    id
    title
    customFields {
      id
      customField {
        name
        type
      }
      text
      regionCode
    }
  }
}

ការឆ្លើយតប

TodoCustomField ការឆ្លើយតប

វាល	ប្រភេទ	ការពិពណ៌នា
id	String!	អត្តសញ្ញាណឯកតាសម្រាប់តម្លៃវាល
customField	CustomField!	ការបកស្រាយកន្លែងផ្ទុក
text	String	លេខទូរស័ព្ទដែលបានទ្រង់ទ្រាយ (ទ្រង់ទ្រាយអន្តរជាតិ)
regionCode	String	កូដប្រទេស (ឧ. "US", "GB", "CA")
todo	Todo!	កំណត់ត្រានេះមានតម្លៃ
createdAt	DateTime!	ពេលដែលតម្លៃត្រូវបានបង្កើត
updatedAt	DateTime!	ពេលដែលតម្លៃបានធ្វើអាប់ដេតចុងក្រោយ

ការផ្ទៀងផ្ទាត់លេខទូរស័ព្ទ

សំខាន់: ការផ្ទៀងផ្ទាត់លេខទូរស័ព្ទ និងការទ្រង់ទ្រាយត្រូវបានអនុវត្តតែពេលបង្កើតកំណត់ត្រាថ្មីតាមរយៈ createTodo។ នៅពេលធ្វើអាប់ដេតតម្លៃទូរស័ព្ទដែលមានស្រាប់ដោយប្រើ setTodoCustomField, មិនមានការផ្ទៀងផ្ទាត់ត្រូវបានអនុវត្តនិងតម្លៃត្រូវបានរក្សាទុកដូចដែលបានផ្តល់។

ទ្រង់ទ្រាយដែលទទួលយក (ក្នុងការបង្កើតកំណត់ត្រា)

លេខទូរស័ព្ទត្រូវតែមានកូដប្រទេសក្នុងទ្រង់ទ្រាយណាមួយទាំងនេះ:

• ទ្រង់ទ្រាយ E.164 (ដែលបានផ្តល់អាទិភាព): +12345678900
• ទ្រង់ទ្រាយអន្តរជាតិ: +1 234 567 8900
• អន្តរជាតិក្នុងការបញ្ចូលសញ្ញា: +1 (234) 567-8900
• កូដប្រទេសជាមួយសញ្ញាដេក: +1-234-567-8900

ចំណាំ: ទ្រង់ទ្រាយជាតិនៅឥតមានកូដប្រទេស (ដូចជា (234) 567-8900) នឹងត្រូវបានបដិសេធនៅពេលបង្កើតកំណត់ត្រា។

ច្បាប់ផ្ទៀងផ្ទាត់ (ក្នុងការបង្កើតកំណត់ត្រា)

• ប្រើ libphonenumber-js សម្រាប់ការបកស្រាយ និងការផ្ទៀងផ្ទាត់
• ទទួលយកទ្រង់ទ្រាយលេខទូរស័ព្ទអន្តរជាតិជាច្រើន
• រកឃើញប្រទេសដោយស្វ័យប្រវត្តិពីលេខ
• ទ្រង់ទ្រាយលេខក្នុងទ្រង់ទ្រាយបង្ហាញអន្តរជាតិ (ឧ. +1 234 567 8900)
• ដក និងរក្សាទុកកូដប្រទេសដោយឡែក (ឧ. US)

ឧទាហរណ៍លេខទូរស័ព្ទដែលមានសុពលភាព

+12345678900           # E.164 format
+1 234 567 8900        # International format
+1 (234) 567-8900      # With parentheses
+1-234-567-8900        # With dashes
+44 20 7946 0958       # UK number
+33 1 42 86 83 26      # French number

ឧទាហរណ៍លេខទូរស័ព្ទដែលមិនមានសុពលភាព

(234) 567-8900         # Missing country code
234-567-8900           # Missing country code
123                    # Too short
invalid-phone          # Not a number
+1 234                 # Incomplete number

ទ្រង់ទ្រាយស្តុក

នៅពេលបង្កើតកំណត់ត្រាជាមួយលេខទូរស័ព្ទ:

• អត្ថបទ: ត្រូវបានរក្សាទុកក្នុងទ្រង់ទ្រាយអន្តរជាតិ (ឧ. +1 234 567 8900) បន្ទាប់ពីការផ្ទៀងផ្ទាត់
• regionCode: ត្រូវបានរក្សាទុកជាកូដប្រទេស ISO (ឧ. US, GB, CA) ដែលត្រូវបានរកឃើញដោយស្វ័យប្រវត្តិ

នៅពេលធ្វើអាប់ដេតតាមរយៈ setTodoCustomField:

• អត្ថបទ: ត្រូវបានរក្សាទុកយ៉ាងត្រឹមត្រូវដូចដែលបានផ្តល់ (មិនមានការទ្រង់ទ្រាយ)
• regionCode: ត្រូវបានរក្សាទុកយ៉ាងត្រឹមត្រូវដូចដែលបានផ្តល់ (មិនមានការផ្ទៀងផ្ទាត់)

អាជ្ញាប័ណ្ណដែលត្រូវការ

សកម្មភាព	អាជ្ញាប័ណ្ណដែលត្រូវការ
Create phone field	OWNER or ADMIN role at project level
Update phone field	OWNER or ADMIN role at project level
Set phone value	Standard record edit permissions
View phone value	Standard record view permissions

ការឆ្លើយតបកំហុស

ទ្រង់ទ្រាយទូរស័ព្ទមិនត្រឹមត្រូវ

{
  "errors": [{
    "message": "Invalid phone number format.",
    "extensions": {
      "code": "CUSTOM_FIELD_VALUE_PARSE_ERROR"
    }
  }]
}

វាលមិនមាន

{
  "errors": [{
    "message": "Custom field not found",
    "extensions": {
      "code": "CUSTOM_FIELD_NOT_FOUND"
    }
  }]
}

កូដប្រទេសខ្វះ

{
  "errors": [{
    "message": "Invalid phone number format.",
    "extensions": {
      "code": "CUSTOM_FIELD_VALUE_PARSE_ERROR"
    }
  }]
}

អនុស្សាវរីយ៍ល្អ

ការបញ្ចូលទិន្នន័យ

• តែងតែបញ្ចូលកូដប្រទេសនៅក្នុងលេខទូរស័ព្ទ
• ប្រើទ្រង់ទ្រាយ E.164 សម្រាប់ភាពជាប្រព័ន្ធ
• ផ្ទៀងផ្ទាត់លេខមុននឹងរក្សាទុកសម្រាប់ប្រតិបត្តិការសំខាន់
• ពិចារណាអំពីចំណង់ចំណូលចិត្តតំបន់សម្រាប់ការទ្រង់ទ្រាយបង្ហាញ

គុណភាពទិន្នន័យ

• រក្សាទុកលេខក្នុងទ្រង់ទ្រាយអន្តរជាតិសម្រាប់ភាពសមស្របជាសកល
• ប្រើ regionCode សម្រាប់លក្ខណៈពិសេសដែលពាក់ព័ន្ធនឹងប្រទេស
• ផ្ទៀងផ្ទាត់លេខទូរស័ព្ទមុននឹងប្រតិបត្តិការសំខាន់ (SMS, ការហៅ)
• ពិចារណាអំពីផលប៉ះពាល់នៃតំបន់ពេលសម្រាប់ការទំនាក់ទំនង

ការពិចារណាអន្តរជាតិ

• កូដប្រទេសត្រូវបានរកឃើញដោយស្វ័យប្រវត្តិ និងរក្សាទុក
• លេខត្រូវបានទ្រង់ទ្រាយក្នុងស្តង់ដារអន្តរជាតិ
• ចំណង់ចំណូលចិត្តក្នុងការបង្ហាញតំបន់អាចប្រើ regionCode
• ពិចារណាអំពីប្រព័ន្ធការហៅក្នុងស្រុកនៅពេលបង្ហាញ

ករណីប្រើទូទៅ

1. ការគ្រប់គ្រងទំនាក់ទំនង

   • លេខទូរស័ព្ទអតិថិជន
   • ព័ត៌មានទំនាក់ទំនងអ្នកផ្គត់ផ្គង់
   • លេខទូរស័ព្ទសមាជិកក្រុម
   • ព័ត៌មានទំនាក់ទំនងគាំទ្រ

2. ទំនាក់ទំនងបន្ទាន់

   • លេខទំនាក់ទំនងបន្ទាន់
   • ព័ត៌មានទំនាក់ទំនងនៅលើការហៅ
   • ទំនាក់ទំនងឆ្លើយតបនៃវិបត្តិ
   • លេខទូរស័ព្ទសម្រាប់ការលើកកម្ពស់

3. គាំទ្រអតិថិជន

   • លេខទូរស័ព្ទអតិថិជន
   • លេខទូរស័ព្ទសម្រាប់ការឆ្លើយតប
   • លេខទូរស័ព្ទសម្រាប់ការផ្ទៀងផ្ទាត់
   • លេខទូរស័ព្ទសម្រាប់ការតាមដាន

4. ការលក់ និងទីផ្សារ

   • លេខទូរស័ព្ទអ្នកដឹកនាំ
   • បញ្ជីទំនាក់ទំនងយុទ្ធនាការ
   • ព័ត៌មានទំនាក់ទំនងដៃគូ
   • លេខទូរស័ព្ទប្រភពយោង

លក្ខណៈពិសេសនៃការបញ្ចូល

ជាមួយការបង្កើតស្វ័យប្រវត្តិ

• បញ្ចូនសកម្មភាពនៅពេលកន្លែងទូរស័ព្ទត្រូវបានធ្វើអាប់ដេត
• ផ្ញើសារសម្តែងទៅលេខទូរស័ព្ទដែលបានរក្សាទុក
• បង្កើតភារកិច្ចតាមដានដោយផ្អែកលើការផ្លាស់ប្តូរទូរស័ព្ទ
• ផ្លូវហៅដោយផ្អែកលើទិន្នន័យលេខទូរស័ព្ទ

ជាមួយការស្វែងរក

• យោងទិន្នន័យទូរស័ព្ទពីកំណត់ត្រាផ្សេងទៀត
• ប្រមូលបញ្ជីលេខទូរស័ព្ទពីប្រភពជាច្រើន
• ស្វែងរកកំណត់ត្រាដោយលេខទូរស័ព្ទ
• ប្រៀបធៀបព័ត៌មានទំនាក់ទំនង

ជាមួយទម្រង់

• ការផ្ទៀងផ្ទាត់លេខទូរស័ព្ទដោយស្វ័យប្រវត្តិ
• ការត្រួតពិនិត្យទ្រង់ទ្រាយអន្តរជាតិ
• ការរកឃើញកូដប្រទេស
• មតិយោបល់ទ្រង់ទ្រាយពេលពិត

ការកំណត់

• ត្រូវការកូដប្រទេសសម្រាប់លេខទាំងអស់
• មិនមានសមត្ថភាព SMS ឬការហៅក្នុងខ្លួន
• មិនមានការផ្ទៀងផ្ទាត់លេខទូរស័ព្ទលើសពីការត្រួតពិនិត្យទ្រង់ទ្រាយ
• មិនមានការរក្សាទុកព័ត៌មានលម្អិតទូរស័ព្ទ (អ្នកផ្គត់ផ្គង់, ប្រភេទ, ល។)
• លេខទ្រង់ទ្រាយជាតិនៅឥតមានកូដប្រទេសត្រូវបានបដិសេធ
• មិនមានការទ្រង់ទ្រាយលេខទូរស័ព្ទដោយស្វ័យប្រវត្តិក្នុង UI លើសពីស្តង់ដារអន្តរជាតិ

ឯកសារដែលពាក់ព័ន្ធ

• វាលអត្ថបទ - សម្រាប់ទិន្នន័យអត្ថបទដែលមិនមែនជាទូរស័ព្ទ
• វាលអ៊ីមែល - សម្រាប់អាសយដ្ឋានអ៊ីមែល
• វាល URL - សម្រាប់អាសយដ្ឋានគេហទំព័រ
• ទិដ្ឋភាពទាំងមូលនៃកន្លែងផ្ទុក - គំនិតទូទៅ