Đẩy lead vào CRM bằng API key

curl "https://api.nextx.vn/api/v1/crm/integrations/contacts?fromDate=2026-09-01&toDate=2026-09-30&byUpdatedAt=true&pageSize=100" \
  -H "X-Api-Key: YOUR_API_KEY"

{
  "items": [
    {
      "id": "8f3c1d2e-....",
      "code": "CT00123",
      "fullName": "Nguyễn Văn A",
      "phone": "0912345678",
      "email": "a@example.com",
      "address": null, "ward": null, "city": "Hà Nội",
      "gender": null, "dob": null,
      "jobTitle": null, "companyName": null,
      "source": "Website",
      "note": "Quan tâm gói cao cấp",
      "assigneeId": "b21e....",
      "lifecycleStage": "Lead",
      "customFields": { "Dong_xe": "SUV" },
      "createdAt": "2026-09-12T03:00:00+00:00",
      "updatedAt": "2026-09-20T08:15:00+00:00"
    }
  ],
  "totalCount": 1,
  "page": 1,
  "pageSize": 100,
  "totalPages": 1,
  "hasNextPage": false,
  "hasPreviousPage": false
}

curl https://api.nextx.vn/api/v1/crm/integrations/contacts/8f3c1d2e-.... \
  -H "X-Api-Key: YOUR_API_KEY"

// Trả đúng một đối tượng có bộ trường như phần tử "items" ở trên.
// Không có khách → 404, errorCode = CONTACT_NOT_FOUND.

curl -X PUT https://api.nextx.vn/api/v1/crm/integrations/contacts/by-phone/0912345678 \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "externalId": "ACC-0042",
    "fullName": "Nguyễn Văn A",
    "city": "Đà Nẵng",
    "createIfMissing": true
  }'

{
  "contactId": "8f3c1d2e-....",
  "code": "CT00123",
  "isNew": false,
  "updated": true,
  "matchedBy": "external_id"
}

const res = await fetch(
  'https://api.nextx.vn/api/v1/crm/integrations/leads',
  {
    method: 'POST',
    headers: {
      'X-Api-Key': process.env.NEXTX_API_KEY,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      fullName: form.name,
      phone: form.phone,
      email: form.email,
      source: 'Website',
      externalId: `WEB-${record.id}`,
    }),
  }
);

const data = await res.json();
if (!res.ok) throw new Error(`${data.errorCode}: ${data.title} (traceId ${data.traceId})`);
console.log(data.contactId, data.isNew);

$payload = [
  'fullName'   => $name,
  'phone'      => $phone,
  'email'      => $email,
  'source'     => 'Website',
  'externalId' => 'WEB-' . $recordId,
];

$ch = curl_init('https://api.nextx.vn/api/v1/crm/integrations/leads');
curl_setopt_array($ch, [
  CURLOPT_POST           => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER     => [
    'X-Api-Key: ' . getenv('NEXTX_API_KEY'),
    'Content-Type: application/json',
  ],
  CURLOPT_POSTFIELDS     => json_encode($payload, JSON_UNESCAPED_UNICODE),
]);

$response = curl_exec($ch);
$status   = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);