Intercom API开放平台

Intercom 提供了一个公共 API，允许开发者以编程方式从他们的应用程序中获取数据。这些数据可以用来与其他服务集成，或者构建利用 Intercom 数据的自定义应用程序。

Intercom 提供了许多 API 端点，可以用来获取与用户、对话、消息线程等有关的数据。在这篇博客文章中，我们将探索 Intercom 提供的一些最受欢迎的 API 端点，并为每个端点提供 JavaScript 示例代码。

在开始使用 Intercom API 之前，你需要为你的应用程序生成一个访问令牌。你可以通过登录你的 Intercom 账户，并在 API 密钥设置中生成一个“个人访问令牌”来做到这一点。

生成访问令牌后，你可以在“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 提供了广泛的端点和功能，使开发者能够以编程方式访问和管理他们的 Intercom 账户中的数据。在这篇博客文章中，我们提供了一些最受欢迎的 API 端点的示例 JavaScript 代码。

记得总是指定你的 API 访问令牌来验证你的请求，并查阅 Intercom 的 API 文档以获取更多信息和功能。