Set Up Your Google Cloud Platform Account
- Create a Google Cloud account if you haven’t already by visiting Google Cloud Platform.
- Once signed in, create a new project or select an existing project from the Google Cloud Console.
- Enable the necessary APIs for AI, such as the Cloud Natural Language API or Dialogflow, by navigating to the “APIs & Services” section in the console.
- Set up billing information to access certain AI tools and ensure that your project can utilize Google’s cloud services.
Set Up Intercom Developer Account
- Sign up for an Intercom account at Intercom if you haven’t already.
- Navigate to the developers section once logged in, and create a new app to get your App ID and API Key, which are essential for integration.
Install Google Cloud SDK
- To interact with Google Cloud services, you'll need the Google Cloud SDK, which provides the gcloud command-line tool.
- Follow the instructions for your operating system on the Google Cloud SDK Installation Guide.
- Run the following command to initialize and authenticate your installation:
gcloud init
Develop Your AI Model or Use Google’s Pre-Trained Models
- Decide whether to use pre-trained models provided by Google or develop your own models in TensorFlow using Vertex AI.
- For using Google’s pre-trained models, follow the API documentation for specific models like Vision AI or Natural Language AI.
Create a Service Account and JWT Token
- Create a service account for your project in the Google Cloud Console under “IAM & Admin”.
- Generate a JSON key file and download it. This will allow your Intercom app to authenticate requests to Google Cloud services.
- Ensure you have proper permissions assigned to the service account for the AI services you're planning to use.
Set Up Intercom Webhooks
- Navigate to the webhooks section in your Intercom developer console and set up a new webhook to listen for events like new messages.
- Define the URL endpoint that will handle these incoming requests and process them to interact with your AI model on Google Cloud.
Develop the Integration Functionality
- Set up a server (using Node.js, Python, etc.) to handle incoming webhook events from Intercom.
- Install the necessary libraries to connect to both Intercom and Google Cloud AI. For example, using npm for Node.js:
npm install @google-cloud/language intercom-client express
- Write a script to process incoming messages from Intercom, send them to your AI model on Google Cloud, and respond back to Intercom. Example in Node.js:
const express = require('express');
const { LanguageServiceClient } = require('@google-cloud/language');
const Intercom = require('intercom-client');
const app = express();
const port = 3000;
const client = new Intercom.Client({ token: 'YOUR_INTERCOM_ACCESS_TOKEN' });
const languageClient = new LanguageServiceClient();
app.use(express.json());
app.post('/webhook', async (req, res) => {
const message = req.body.data.item.conversation_message.body;
const document = {
content: message,
type: 'PLAIN_TEXT',
};
const [result] = await languageClient.analyzeSentiment({ document });
const sentiment = result.documentSentiment;
client.messages.reply({
id: req.body.data.item.id,
type: 'admin',
message_type: 'comment',
admin_id: 'YOUR_ADMIN_ID',
body: `The sentiment score is ${sentiment.score}`,
});
res.sendStatus(200);
});
app.listen(port, () => console.log(`App listening on port ${port}`));
Deploy Your Application
- Deploy your integration on a reliable server or cloud service. You could use Google Cloud’s App Engine for a seamless solution.
- Ensure that your application is constantly running and publicly accessible for Intercom to send webhook events.
Test and Monitor Your Integration
- Send test messages through Intercom and verify that the responses processed by your Google Cloud AI integration are accurate and timely.
- Monitor logs in both Intercom and Google Cloud to ensure the integration is functioning as expected and troubleshoot any potential issues.
Maintenance and Updates
- Regularly update your Google Cloud AI models and libraries to take advantage of improvements and new features.
- Adjust the sentiment analysis and responses in your application as needed based on user feedback and new requirements.
