mirror of
https://github.com/lingble/chatwoot.git
synced 2025-10-29 02:02:27 +00:00
## Description This PR introduces WhatsApp Embedded Signup functionality, enabling users to connect their WhatsApp Business accounts through Meta's streamlined OAuth flow without manual webhook configuration. This significantly improves the user experience by automating the entire setup process. **Key Features:** - Embedded signup flow using Facebook SDK and Meta's OAuth 2.0 - Automatic webhook registration and phone number configuration - Enhanced provider selection UI with card-based design - Real-time progress tracking during signup process - Comprehensive error handling and user feedback ## Required Configuration The following environment variables must be configured by administrators before this feature can be used: Super Admin Configuration (via super_admin/app_config?config=whatsapp_embedded) - `WHATSAPP_APP_ID`: The Facebook App ID for WhatsApp Business API integration - `WHATSAPP_CONFIGURATION_ID`: The Configuration ID for WhatsApp Embedded Signup flow (obtained from Meta Developer Portal) - `WHATSAPP_APP_SECRET`: The App Secret for WhatsApp Embedded Signup flow (required for token exchange)  ## How Has This Been Tested? #### Backend Tests (RSpec): - Authentication validation for embedded signup endpoints - Authorization code validation and error handling - Missing business parameter validation - Proper response format for configuration endpoint - Unauthorized access prevention #### Manual Test Cases: - Complete embedded signup flow (happy path) - Provider selection UI navigation - Facebook authentication popup handling - Error scenarios (cancelled auth, invalid business data, API failures) - Configuration presence/absence behavior ## Related Screenshots:      Fixes https://linear.app/chatwoot/issue/CW-2131/spec-for-whatsapp-cloud-channels-sign-in-with-facebook --------- Co-authored-by: Muhsin Keloth <muhsinkeramam@gmail.com> Co-authored-by: Copilot Autofix powered by AI <62310815+github-advanced-security[bot]@users.noreply.github.com> Co-authored-by: iamsivin <iamsivin@gmail.com> Co-authored-by: Sivin Varghese <64252451+iamsivin@users.noreply.github.com> Co-authored-by: Sojan Jose <sojan@pepalo.com>
303 lines
10 KiB
JavaScript
303 lines
10 KiB
JavaScript
import * as MutationHelpers from 'shared/helpers/vuex/mutationHelpers';
|
|
import * as types from '../mutation-types';
|
|
import { INBOX_TYPES } from 'dashboard/helper/inbox';
|
|
import InboxesAPI from '../../api/inboxes';
|
|
import WebChannel from '../../api/channel/webChannel';
|
|
import FBChannel from '../../api/channel/fbChannel';
|
|
import TwilioChannel from '../../api/channel/twilioChannel';
|
|
import WhatsappChannel from '../../api/channel/whatsappChannel';
|
|
import { throwErrorMessage } from '../utils/api';
|
|
import AnalyticsHelper from '../../helper/AnalyticsHelper';
|
|
import camelcaseKeys from 'camelcase-keys';
|
|
import { ACCOUNT_EVENTS } from '../../helper/AnalyticsHelper/events';
|
|
import { channelActions, buildInboxData } from './inboxes/channelActions';
|
|
|
|
export const state = {
|
|
records: [],
|
|
uiFlags: {
|
|
isFetching: false,
|
|
isFetchingItem: false,
|
|
isCreating: false,
|
|
isUpdating: false,
|
|
isDeleting: false,
|
|
isUpdatingIMAP: false,
|
|
isUpdatingSMTP: false,
|
|
},
|
|
};
|
|
|
|
export const getters = {
|
|
getInboxes($state) {
|
|
return $state.records;
|
|
},
|
|
getWhatsAppTemplates: $state => inboxId => {
|
|
const [inbox] = $state.records.filter(
|
|
record => record.id === Number(inboxId)
|
|
);
|
|
|
|
const {
|
|
message_templates: whatsAppMessageTemplates,
|
|
additional_attributes: additionalAttributes,
|
|
} = inbox || {};
|
|
|
|
const { message_templates: apiInboxMessageTemplates } =
|
|
additionalAttributes || {};
|
|
const messagesTemplates =
|
|
whatsAppMessageTemplates || apiInboxMessageTemplates;
|
|
|
|
// filtering out the whatsapp templates with media
|
|
if (messagesTemplates instanceof Array) {
|
|
return messagesTemplates.filter(template => {
|
|
return !template.components.some(
|
|
i => i.format === 'IMAGE' || i.format === 'VIDEO'
|
|
);
|
|
});
|
|
}
|
|
return [];
|
|
},
|
|
getNewConversationInboxes($state) {
|
|
return $state.records.filter(inbox => {
|
|
const { channel_type: channelType, phone_number: phoneNumber = '' } =
|
|
inbox;
|
|
|
|
const isEmailChannel = channelType === INBOX_TYPES.EMAIL;
|
|
const isSmsChannel =
|
|
channelType === INBOX_TYPES.TWILIO &&
|
|
phoneNumber.startsWith('whatsapp');
|
|
return isEmailChannel || isSmsChannel;
|
|
});
|
|
},
|
|
getInbox: $state => inboxId => {
|
|
const [inbox] = $state.records.filter(
|
|
record => record.id === Number(inboxId)
|
|
);
|
|
return inbox || {};
|
|
},
|
|
getInboxById: $state => inboxId => {
|
|
const [inbox] = $state.records.filter(
|
|
record => record.id === Number(inboxId)
|
|
);
|
|
return camelcaseKeys(inbox || {}, { deep: true });
|
|
},
|
|
getUIFlags($state) {
|
|
return $state.uiFlags;
|
|
},
|
|
getWebsiteInboxes($state) {
|
|
return $state.records.filter(item => item.channel_type === INBOX_TYPES.WEB);
|
|
},
|
|
getTwilioInboxes($state) {
|
|
return $state.records.filter(
|
|
item => item.channel_type === INBOX_TYPES.TWILIO
|
|
);
|
|
},
|
|
getSMSInboxes($state) {
|
|
return $state.records.filter(
|
|
item =>
|
|
item.channel_type === INBOX_TYPES.SMS ||
|
|
(item.channel_type === INBOX_TYPES.TWILIO && item.medium === 'sms')
|
|
);
|
|
},
|
|
dialogFlowEnabledInboxes($state) {
|
|
return $state.records.filter(
|
|
item => item.channel_type !== INBOX_TYPES.EMAIL
|
|
);
|
|
},
|
|
getFacebookInboxByInstagramId: $state => instagramId => {
|
|
return $state.records.find(
|
|
item =>
|
|
item.instagram_id === instagramId &&
|
|
item.channel_type === INBOX_TYPES.FB
|
|
);
|
|
},
|
|
getInstagramInboxByInstagramId: $state => instagramId => {
|
|
return $state.records.find(
|
|
item =>
|
|
item.instagram_id === instagramId &&
|
|
item.channel_type === INBOX_TYPES.INSTAGRAM
|
|
);
|
|
},
|
|
};
|
|
|
|
const sendAnalyticsEvent = channelType => {
|
|
AnalyticsHelper.track(ACCOUNT_EVENTS.ADDED_AN_INBOX, {
|
|
channelType,
|
|
});
|
|
};
|
|
|
|
export const actions = {
|
|
revalidate: async ({ commit }, { newKey }) => {
|
|
try {
|
|
const isExistingKeyValid = await InboxesAPI.validateCacheKey(newKey);
|
|
if (!isExistingKeyValid) {
|
|
const response = await InboxesAPI.refetchAndCommit(newKey);
|
|
commit(types.default.SET_INBOXES, response.data.payload);
|
|
}
|
|
} catch (error) {
|
|
// Ignore error
|
|
}
|
|
},
|
|
get: async ({ commit }) => {
|
|
commit(types.default.SET_INBOXES_UI_FLAG, { isFetching: true });
|
|
try {
|
|
const response = await InboxesAPI.get(true);
|
|
commit(types.default.SET_INBOXES_UI_FLAG, { isFetching: false });
|
|
commit(types.default.SET_INBOXES, response.data.payload);
|
|
} catch (error) {
|
|
commit(types.default.SET_INBOXES_UI_FLAG, { isFetching: false });
|
|
}
|
|
},
|
|
createChannel: async ({ commit }, params) => {
|
|
try {
|
|
commit(types.default.SET_INBOXES_UI_FLAG, { isCreating: true });
|
|
const response = await WebChannel.create(params);
|
|
commit(types.default.ADD_INBOXES, response.data);
|
|
commit(types.default.SET_INBOXES_UI_FLAG, { isCreating: false });
|
|
const { channel = {} } = params;
|
|
sendAnalyticsEvent(channel.type);
|
|
return response.data;
|
|
} catch (error) {
|
|
const errorMessage = error?.response?.data?.message;
|
|
commit(types.default.SET_INBOXES_UI_FLAG, { isCreating: false });
|
|
throw new Error(errorMessage);
|
|
}
|
|
},
|
|
createWebsiteChannel: async ({ commit }, params) => {
|
|
try {
|
|
commit(types.default.SET_INBOXES_UI_FLAG, { isCreating: true });
|
|
const response = await WebChannel.create(buildInboxData(params));
|
|
commit(types.default.ADD_INBOXES, response.data);
|
|
commit(types.default.SET_INBOXES_UI_FLAG, { isCreating: false });
|
|
sendAnalyticsEvent('website');
|
|
return response.data;
|
|
} catch (error) {
|
|
commit(types.default.SET_INBOXES_UI_FLAG, { isCreating: false });
|
|
return throwErrorMessage(error);
|
|
}
|
|
},
|
|
createTwilioChannel: async ({ commit }, params) => {
|
|
try {
|
|
commit(types.default.SET_INBOXES_UI_FLAG, { isCreating: true });
|
|
const response = await TwilioChannel.create(params);
|
|
commit(types.default.ADD_INBOXES, response.data);
|
|
commit(types.default.SET_INBOXES_UI_FLAG, { isCreating: false });
|
|
sendAnalyticsEvent('twilio');
|
|
return response.data;
|
|
} catch (error) {
|
|
commit(types.default.SET_INBOXES_UI_FLAG, { isCreating: false });
|
|
throw error;
|
|
}
|
|
},
|
|
createFBChannel: async ({ commit }, params) => {
|
|
try {
|
|
commit(types.default.SET_INBOXES_UI_FLAG, { isCreating: true });
|
|
const response = await FBChannel.create(params);
|
|
commit(types.default.ADD_INBOXES, response.data);
|
|
commit(types.default.SET_INBOXES_UI_FLAG, { isCreating: false });
|
|
sendAnalyticsEvent('facebook');
|
|
return response.data;
|
|
} catch (error) {
|
|
commit(types.default.SET_INBOXES_UI_FLAG, { isCreating: false });
|
|
throw new Error(error);
|
|
}
|
|
},
|
|
createWhatsAppEmbeddedSignup: async ({ commit }, params) => {
|
|
try {
|
|
commit(types.default.SET_INBOXES_UI_FLAG, { isCreating: true });
|
|
const response = await WhatsappChannel.createEmbeddedSignup(params);
|
|
commit(types.default.ADD_INBOXES, response.data);
|
|
commit(types.default.SET_INBOXES_UI_FLAG, { isCreating: false });
|
|
sendAnalyticsEvent('whatsapp');
|
|
return response.data;
|
|
} catch (error) {
|
|
commit(types.default.SET_INBOXES_UI_FLAG, { isCreating: false });
|
|
throw error;
|
|
}
|
|
},
|
|
...channelActions,
|
|
// TODO: Extract other create channel methods to separate files to reduce file size
|
|
// - createChannel
|
|
// - createWebsiteChannel
|
|
// - createTwilioChannel
|
|
// - createFBChannel
|
|
updateInbox: async ({ commit }, { id, formData = true, ...inboxParams }) => {
|
|
commit(types.default.SET_INBOXES_UI_FLAG, { isUpdating: true });
|
|
try {
|
|
const response = await InboxesAPI.update(
|
|
id,
|
|
formData ? buildInboxData(inboxParams) : inboxParams
|
|
);
|
|
commit(types.default.EDIT_INBOXES, response.data);
|
|
commit(types.default.SET_INBOXES_UI_FLAG, { isUpdating: false });
|
|
} catch (error) {
|
|
commit(types.default.SET_INBOXES_UI_FLAG, { isUpdating: false });
|
|
throwErrorMessage(error);
|
|
}
|
|
},
|
|
updateInboxIMAP: async ({ commit }, { id, ...inboxParams }) => {
|
|
commit(types.default.SET_INBOXES_UI_FLAG, { isUpdatingIMAP: true });
|
|
try {
|
|
const response = await InboxesAPI.update(id, inboxParams);
|
|
commit(types.default.EDIT_INBOXES, response.data);
|
|
commit(types.default.SET_INBOXES_UI_FLAG, { isUpdatingIMAP: false });
|
|
} catch (error) {
|
|
commit(types.default.SET_INBOXES_UI_FLAG, { isUpdatingIMAP: false });
|
|
throwErrorMessage(error);
|
|
}
|
|
},
|
|
updateInboxSMTP: async ({ commit }, { id, ...inboxParams }) => {
|
|
commit(types.default.SET_INBOXES_UI_FLAG, { isUpdatingSMTP: true });
|
|
try {
|
|
const response = await InboxesAPI.update(id, inboxParams);
|
|
commit(types.default.EDIT_INBOXES, response.data);
|
|
commit(types.default.SET_INBOXES_UI_FLAG, { isUpdatingSMTP: false });
|
|
} catch (error) {
|
|
commit(types.default.SET_INBOXES_UI_FLAG, { isUpdatingSMTP: false });
|
|
throwErrorMessage(error);
|
|
}
|
|
},
|
|
delete: async ({ commit }, inboxId) => {
|
|
commit(types.default.SET_INBOXES_UI_FLAG, { isDeleting: true });
|
|
try {
|
|
await InboxesAPI.delete(inboxId);
|
|
commit(types.default.DELETE_INBOXES, inboxId);
|
|
commit(types.default.SET_INBOXES_UI_FLAG, { isDeleting: false });
|
|
} catch (error) {
|
|
commit(types.default.SET_INBOXES_UI_FLAG, { isDeleting: false });
|
|
throw new Error(error);
|
|
}
|
|
},
|
|
reauthorizeFacebookPage: async ({ commit }, params) => {
|
|
try {
|
|
const response = await FBChannel.reauthorizeFacebookPage(params);
|
|
commit(types.default.EDIT_INBOXES, response.data);
|
|
} catch (error) {
|
|
throw new Error(error.message);
|
|
}
|
|
},
|
|
deleteInboxAvatar: async (_, inboxId) => {
|
|
try {
|
|
await InboxesAPI.deleteInboxAvatar(inboxId);
|
|
} catch (error) {
|
|
throw new Error(error);
|
|
}
|
|
},
|
|
};
|
|
|
|
export const mutations = {
|
|
[types.default.SET_INBOXES_UI_FLAG]($state, uiFlag) {
|
|
$state.uiFlags = { ...$state.uiFlags, ...uiFlag };
|
|
},
|
|
[types.default.SET_INBOXES]: MutationHelpers.set,
|
|
[types.default.SET_INBOXES_ITEM]: MutationHelpers.setSingleRecord,
|
|
[types.default.ADD_INBOXES]: MutationHelpers.create,
|
|
[types.default.EDIT_INBOXES]: MutationHelpers.update,
|
|
[types.default.DELETE_INBOXES]: MutationHelpers.destroy,
|
|
};
|
|
|
|
export default {
|
|
namespaced: true,
|
|
state,
|
|
getters,
|
|
actions,
|
|
mutations,
|
|
};
|