Intercom 提供了一個公共 API，允許開發(fā)者以編程方式從他們的應(yīng)用程序中獲取數(shù)據(jù)。這些數(shù)據(jù)可以用來與其他服務(wù)集成，或者構(gòu)建利用 Intercom 數(shù)據(jù)的自定義應(yīng)用程序。

Intercom 提供了許多 API 端點，可以用來獲取與用戶、對話、消息線程等有關(guān)的數(shù)據(jù)。在這篇博客文章中，我們將探索 Intercom 提供的一些最受歡迎的 API 端點，并為每個端點提供 JavaScript 示例代碼。

在開始使用 Intercom API 之前，你需要為你的應(yīng)用程序生成一個訪問令牌。你可以通過登錄你的 Intercom 賬戶，并在 API 密鑰設(shè)置中生成一個“個人訪問令牌”來做到這一點。

生成訪問令牌后，你可以在“Authorization”頭中包含它來驗證你的請求，如下所示：

const baseURL = "https://api.intercom.io";
const accessToken = "YOUR_ACCESS_TOKEN";

axios.defaults.headers.common.Authorization = `Bearer ${accessToken}`;
axios.defaults.headers.post["Content-Type"] = "application/json";

用戶 API 端點用于獲取你的 Intercom 賬戶中的用戶信息。你可以使用這些端點來獲取用戶屬性，如姓名、電子郵件地址和用戶 ID。

axios.get(`${baseURL}/users`, {
  params: {
    per_page: 50
  }
})
.then(response => {
  console.log(response.data);
})
.catch(error => {
  console.log(error);
});

axios.get(`${baseURL}/users/${userId}`)
  .then(response => {
    console.log(response.data);
  })
  .catch(error => {
    console.log(error);
  });

axios.post(`${baseURL}/users`, {
    email: "john.doe@example.com",
    name: "John Doe",
    signed_up_at: new Date().toISOString()
})
.then(response => {
    console.log(response.data);
})
.catch(error => {
    console.log(error);
});

對話 API 端點用于獲取你的 Intercom 賬戶中的對話信息。

axios.get(`${baseURL}/conversations`, {
  params: {
    per_page: 50
  }
})
.then(response => {
  console.log(response.data);
})
.catch(error => {
  console.log(error);
});

axios.get(`${baseURL}/conversations/${conversationId}`)
  .then(response => {
    console.log(response.data);
  })
  .catch(error => {
    console.log(error);
  });

axios.post(`${baseURL}/conversations`, {
    message_type: "inapp",
    body: "Hello, how can I assist you?",
    from: {
        type: "admin",
        id: "YOUR_ADMIN_ID"
    },
    to: {
        type: "user",
        id: "USER_ID"
    },
    assignee: {
        type: "admin",
        id: "YOUR_ADMIN_ID"
    }
})
.then(response => {
    console.log(response.data);
})
.catch(error => {
    console.log(error);
});

Intercom 的公共 API 提供了廣泛的端點和功能，使開發(fā)者能夠以編程方式訪問和管理他們的 Intercom 賬戶中的數(shù)據(jù)。在這篇博客文章中，我們提供了一些最受歡迎的 API 端點的示例 JavaScript 代碼。

記得總是指定你的 API 訪問令牌來驗證你的請求，并查閱 Intercom 的 API 文檔以獲取更多信息和功能。