π¨ The ultimate agentic social media scheduling tool π€
TypeScript nextjsopen-sourceopen-source-social-media-scheduling-toolosspostiz-cloudpostiz-hostedredisscheduling-toolsocial-media-scheduling-tooltypescript
feat: facebook
Nevo David7113c6cebbed
diff --git a/apps/backend/src/api/routes/public.controller.ts b/apps/backend/src/api/routes/public.controller.tsindex 235f82a77..c009440e7 100644--- a/apps/backend/src/api/routes/public.controller.ts+++ b/apps/backend/src/api/routes/public.controller.ts@@ -98,15 +98,19 @@ export class PublicController {body: { fbclid?: string; tt: TrackEnum; additional: Record<string, any> }) {const uniqueId = req?.cookies?.track || makeId(10);- const fbclid = req?.cookies?.fbclid || body.fbclid;- await this._trackService.track(- uniqueId,- ip,- userAgent,- body.tt,- body.additional,- fbclid- );+ const fbc = req?.cookies?._fbc || req?.cookies?.fbclid || body.fbclid;+ this._trackService+ .track(+ uniqueId,+ ip,+ userAgent,+ body.tt,+ body.additional,+ fbc,+ undefined,+ req?.cookies?._fbp+ )+ .catch((err) => {});if (!req.cookies.track) {res.cookie('track', uniqueId, {domain: getCookieUrlFromDomain(process.env.FRONTEND_URL!),diff --git a/apps/backend/src/api/routes/users.controller.ts b/apps/backend/src/api/routes/users.controller.tsindex eb0af7e1d..1f0a6e39e 100644--- a/apps/backend/src/api/routes/users.controller.ts+++ b/apps/backend/src/api/routes/users.controller.ts@@ -413,16 +413,19 @@ export class UsersController {body: { tt: TrackEnum; fbclid: string; additional: Record<string, any> }) {const uniqueId = req?.cookies?.track || makeId(10);- const fbclid = req?.cookies?.fbclid || body.fbclid;- await this._trackService.track(- uniqueId,- ip,- userAgent,- body.tt,- body.additional,- fbclid,- user- );+ const fbc = req?.cookies?._fbc || req?.cookies?.fbclid || body.fbclid;+ this._trackService+ .track(+ uniqueId,+ ip,+ userAgent,+ body.tt,+ body.additional,+ fbc,+ user,+ req?.cookies?._fbp+ )+ .catch((err) => {});if (!req.cookies.track) {res.cookie('track', uniqueId, {domain: getCookieUrlFromDomain(process.env.FRONTEND_URL!),diff --git a/apps/frontend/src/components/billing/first.billing.component.tsx b/apps/frontend/src/components/billing/first.billing.component.tsxindex 7cb67048c..116ba58f7 100644--- a/apps/frontend/src/components/billing/first.billing.component.tsx+++ b/apps/frontend/src/components/billing/first.billing.component.tsx@@ -60,6 +60,8 @@ export const FirstBillingComponent = () => {const t = useT();const [datafast_visitor_id] = useCookie('datafast_visitor_id', '');const [datafast_session_id] = useCookie('datafast_session_id', '');+ const [fbc] = useCookie('_fbc', '');+ const [fbp] = useCookie('_fbp', '');useEffect(() => {const stripePromise = loadStripe(stripeClient);@@ -78,6 +80,8 @@ export const FirstBillingComponent = () => {? { datafast_visitor_id, datafast_session_id }: {}),...(dub ? { dub } : {}),+ ...(fbc ? { fbc } : {}),+ ...(fbp ? { fbp } : {}),}),})).json();diff --git a/apps/frontend/src/components/billing/main.billing.component.tsx b/apps/frontend/src/components/billing/main.billing.component.tsxindex 13ccb2fe3..133a9a37c 100644--- a/apps/frontend/src/components/billing/main.billing.component.tsx+++ b/apps/frontend/src/components/billing/main.billing.component.tsx@@ -31,6 +31,7 @@ import { newDayjs } from '@gitroom/frontend/components/layout/set.timezone';import { timer } from '@gitroom/helpers/utils/timer';import { useDubClickId } from '@gitroom/frontend/components/layout/dubAnalytics';import { LogoutComponent } from '@gitroom/frontend/components/layout/logout.component';+import useCookie from 'react-use-cookie';type SubscriptionWithPlatform = Subscription & {platform?: 'web' | 'mobile';@@ -466,6 +467,8 @@ export const MainBillingComponent: FC<{const toast = useToaster();const user = useUser();const dub = useDubClickId();+ const [fbc] = useCookie('_fbc', '');+ const [fbp] = useCookie('_fbp', '');const modal = useModals();const router = useRouter();const utm = useUtmUrl();@@ -687,6 +690,8 @@ export const MainBillingComponent: FC<{utm,billing,...(dub ? { dub } : {}),+ ...(fbc ? { fbc } : {}),+ ...(fbp ? { fbp } : {}),}),})).json();@@ -708,6 +713,7 @@ export const MainBillingComponent: FC<{pricing[billing][monthlyOrYearly === 'on' ? 'year_price' : 'month_price'],+ currency: 'USD',});window.location.href = url;return;diff --git a/libraries/helpers/src/utils/utm.saver.tsx b/libraries/helpers/src/utils/utm.saver.tsxindex d05fa066b..5b7de9d39 100644--- a/libraries/helpers/src/utils/utm.saver.tsx+++ b/libraries/helpers/src/utils/utm.saver.tsx@@ -3,21 +3,19 @@import { FC, useCallback, useEffect } from 'react';import { useSearchParams } from 'next/navigation';import { useLocalStorage } from '@mantine/hooks';-import { TrackEnum } from '@gitroom/nestjs-libraries/user/track.enum';import { useFireEvents } from '@gitroom/helpers/utils/use.fire.events';-import { useTrack } from '@gitroom/react/helpers/use.track';const UtmSaver: FC = () => {const query = useSearchParams();const [value, setValue] = useLocalStorage({ key: 'utm', defaultValue: '' });const searchParams = useSearchParams();const fireEvents = useFireEvents();- const track = useTrack();+ // the Facebook pixel StartTrial is sent by the backend once Stripe confirms+ // the trial, firing it here as well would count it twiceuseEffect(() => {if (searchParams.get('check')) {fireEvents('purchase');- track(TrackEnum.StartTrial);}}, []);diff --git a/libraries/nestjs-libraries/src/dtos/billing/billing.subscribe.dto.ts b/libraries/nestjs-libraries/src/dtos/billing/billing.subscribe.dto.tsindex f1247f067..55cf35363 100644--- a/libraries/nestjs-libraries/src/dtos/billing/billing.subscribe.dto.ts+++ b/libraries/nestjs-libraries/src/dtos/billing/billing.subscribe.dto.ts@@ -1,4 +1,5 @@import { IsIn } from 'class-validator';+import { Transform } from 'class-transformer';export class BillingSubscribeDto {@IsIn(['MONTHLY', 'YEARLY'])@@ -13,4 +14,17 @@ export class BillingSubscribeDto {datafast_session_id: string;datafast_visitor_id: string;++ // Facebook pixel cookies (_fbc / _fbp), saved on the subscription for the+ // trial and conversion events. A value that doesn't fit Stripe metadata+ // (500 chars) is dropped instead of failing the checkout.+ @Transform(({ value }) =>+ typeof value === 'string' && value.length <= 500 ? value : undefined+ )+ fbc: string;++ @Transform(({ value }) =>+ typeof value === 'string' && value.length <= 500 ? value : undefined+ )+ fbp: string;}diff --git a/libraries/nestjs-libraries/src/services/stripe.service.ts b/libraries/nestjs-libraries/src/services/stripe.service.tsindex ca23a23fb..96ff13bba 100644--- a/libraries/nestjs-libraries/src/services/stripe.service.ts+++ b/libraries/nestjs-libraries/src/services/stripe.service.ts@@ -182,7 +182,7 @@ export class StripeService extends PaymentProviderAbstract {return { ok: false };}- return this._subscriptionService.createOrUpdateSubscription(+ const result = await this._subscriptionService.createOrUpdateSubscription(STRIPE_PROVIDER,event.data.object.status !== 'active',uniqueId,@@ -192,6 +192,22 @@ export class StripeService extends PaymentProviderAbstract {period,event.data.object.cancel_at);++ if (event.data.object.status === 'trialing') {+ this.trackSubscription(+ event.data.object.metadata,+ event.data.object.id,+ TrackEnum.StartTrial,+ {+ value:+ pricing[billing][+ period === 'YEARLY' ? 'year_price' : 'month_price'+ ],+ }+ ).catch((err) => {});+ }++ return result;}async updateSubscription(event: Stripe.CustomerSubscriptionUpdatedEvent) {const { uniqueId, billing, period } = event.data.object.metadata as {@@ -1084,25 +1100,107 @@ export class StripeService extends PaymentProviderAbstract {}async paymentSucceeded(event: Stripe.InvoicePaymentSucceededEvent) {- // get subscription from payment- const subscriptionId =- event.data.object.parent?.subscription_details?.subscription;- if (!subscriptionId) {- return { ok: true };- }- const subscription = await stripe.subscriptions.retrieve(- typeof subscriptionId === 'string' ? subscriptionId : subscriptionId.id- );+ // only feeds the Facebook pixel, it runs in the background so it can+ // never fail or slow down the webhook+ this.trackConversion(event.data.object).catch((err) => {});+ return { ok: true };+ }- const { userId, ud } = subscription.metadata;- const user = await this._userService.getUserById(userId);- if (user && user.ip && user.agent) {- this._trackService.track(ud, user.ip, user.agent, TrackEnum.Purchase, {- value: event.data.object.amount_paid / 100,+ // The first charge of a subscription is the conversion: a trial that turned+ // into a paid plan, or a plan paid upfront. The $0 invoice that starts a+ // trial and the renewals are not tracked.+ private async trackConversion(invoice: Stripe.Invoice) {+ try {+ // webhook payloads follow the API version of the endpoint: parent is the+ // 2025-03-31+ shape, subscription the older one+ const subscriptionId =+ invoice.parent?.subscription_details?.subscription ||+ (invoice as any).subscription;+ if (!subscriptionId || invoice.amount_paid <= 0) {+ return;+ }++ // invoices of other services sharing the Stripe account stop here+ const subscription = await stripe.subscriptions.retrieve(+ typeof subscriptionId === 'string' ? subscriptionId : subscriptionId.id+ );+ if (+ subscription.metadata?.service !== 'gitroom' ||+ !subscription.metadata?.userId+ ) {+ return;+ }++ const paidInvoices = await stripe.invoices.list({+ subscription: subscription.id,+ status: 'paid',+ limit: 100,});+ const paidBefore = paidInvoices.data.some(+ (f) =>+ f.id !== invoice.id &&+ f.amount_paid > 0 &&+ (f.created < invoice.created ||+ (f.created === invoice.created && f.id < invoice.id))+ );+ if (paidBefore) {+ return;+ }++ await this.trackSubscription(+ subscription.metadata,+ invoice.id,+ TrackEnum.Purchase,+ {+ value: invoice.amount_paid / 100,+ currency: invoice.currency,+ }+ );+ } catch (err) {+ console.error(+ 'stripe_pixel_conversion_failed',+ { stripe_invoice_id: invoice.id },+ err+ );}+ }- return { ok: true };+ // Facebook pixel event for the user who checked out the subscription.+ // Never throws, tracking must not affect billing.+ private async trackSubscription(+ metadata: Stripe.Metadata,+ eventId: string,+ tt: TrackEnum,+ additional: Record<string, any>+ ) {+ try {+ const { userId, fbc, fbp } = metadata || {};+ if (!userId) {+ return;+ }++ const user = await this._userService.getUserById(userId);+ if (!user) {+ return;+ }++ await this._trackService.track(+ eventId,+ user.ip,+ user.agent,+ tt,+ additional,+ fbc,+ user,+ fbp+ );+ } catch (err) {+ console.error(+ 'stripe_pixel_event_failed',+ { stripe_object_id: eventId, event: TrackEnum[tt] },+ err+ );+ }}async getCharges(organizationId: string) {diff --git a/libraries/nestjs-libraries/src/track/track.service.ts b/libraries/nestjs-libraries/src/track/track.service.tsindex d74c21388..8fdb92599 100644--- a/libraries/nestjs-libraries/src/track/track.service.ts+++ b/libraries/nestjs-libraries/src/track/track.service.ts@@ -1,85 +1,102 @@import { TrackEnum } from '@gitroom/nestjs-libraries/user/track.enum';import { User } from '@prisma/client';import { Injectable } from '@nestjs/common';-import {- ServerEvent,- EventRequest,- UserData,- CustomData,- FacebookAdsApi,-} from 'facebook-nodejs-business-sdk';import { createHash } from 'crypto';+import { META_GRAPH_API_VERSION } from '@gitroom/nestjs-libraries/integrations/social/facebook.provider';-const access_token = process.env.FACEBOOK_PIXEL_ACCESS_TOKEN!;-const pixel_id = process.env.NEXT_PUBLIC_FACEBOOK_PIXEL!;--if (access_token && pixel_id) {- FacebookAdsApi.init(access_token || '');-}-+// The Conversions API is called directly instead of through+// facebook-nodejs-business-sdk: the SDK registers a process wide+// uncaughtException handler on first use that re-throws every error of the+// app (killing the process before Sentry reports it), and its requests have+// no timeout.@Injectable()export class TrackService {private hashValue(value: string) {- return createHash('sha256').update(value).digest('hex');+ return createHash('sha256')+ .update(value.trim().toLowerCase())+ .digest('hex');+ }++ // A _fbc cookie is sent as is, a bare fbclid has to be wrapped as+ // fb.<subdomainIndex>.<creationTime ms>.<fbclid> (index 1 when built on a server)+ private toFbc(fbc: string) {+ return fbc.startsWith('fb.') ? fbc : `fb.1.${Date.now()}.${fbc}`;}- track(++ // Never throws and never rejects: a pixel failure (bad token, Meta outage,+ // timeout) must not break the request or the webhook that fired it, so+ // callers fire it in the background.+ async track(uniqueId: string,ip: string,agent: string,tt: TrackEnum,additional: Record<string, any>,- fbclid?: string,- user?: User+ fbc?: string,+ user?: User,+ fbp?: string) {- if (!access_token || !pixel_id) {+ const accessToken = process.env.FACEBOOK_PIXEL_ACCESS_TOKEN;+ const pixelId = process.env.NEXT_PUBLIC_FACEBOOK_PIXEL;+ const userAgent = agent || user?.agent;+ // website events are rejected without a user agent+ if (!accessToken || !pixelId || !userAgent) {return;}- // @ts-ignore- const current_timestamp = Math.floor(new Date() / 1000);- const userData = new UserData();- if (ip || user?.ip) {- userData.setClientIpAddress(ip || user?.ip || '');- }+ try {+ const clientIp = ip || user?.ip;+ const response = await fetch(+ `https://graph.facebook.com/${META_GRAPH_API_VERSION}/${pixelId}/events`,+ {+ method: 'POST',+ headers: {+ 'Content-Type': 'application/json',+ },+ body: JSON.stringify({+ access_token: accessToken,+ data: [+ {+ event_name: TrackEnum[tt],+ event_time: Math.floor(Date.now() / 1000),+ event_id: uniqueId || user?.id,+ event_source_url: process.env.FRONTEND_URL,+ action_source: 'website',+ user_data: {+ client_user_agent: userAgent,+ ...(clientIp ? { client_ip_address: clientIp } : {}),+ ...(user?.email?.includes('@')+ ? { em: [this.hashValue(user.email)] }+ : {}),+ ...(fbc ? { fbc: this.toFbc(fbc) } : {}),+ ...(fbp ? { fbp } : {}),+ },+ ...(additional?.value+ ? {+ custom_data: {+ value: additional.value,+ currency: (additional.currency || 'USD').toUpperCase(),+ },+ }+ : {}),+ },+ ],+ }),+ signal: AbortSignal.timeout(10000),+ }+ );- if (agent || user?.agent) {- userData.setClientUserAgent(agent || user?.agent || '');- }- if (fbclid) {- userData.setFbc(fbclid);- }+ if (!response.ok) {+ console.error(+ `Facebook pixel rejected ${TrackEnum[tt]}:`,+ await response.text()+ );+ return;+ }- if (user && user.email) {- userData.setEmail(this.hashValue(user.email));+ await response.body?.cancel();+ } catch (err) {+ console.error(`Facebook pixel failed to send ${TrackEnum[tt]}:`, err);}-- let customData = null;- if (additional?.value) {- customData = new CustomData();- customData.setValue(additional.value).setCurrency('USD');- }-- const serverEvent = new ServerEvent()- .setEventName(TrackEnum[tt])- .setEventTime(current_timestamp)- .setActionSource('website');-- if (user && user.id) {- serverEvent.setEventId(uniqueId || user.id);- }-- if (userData) {- serverEvent.setUserData(userData);- }- if (customData) {- serverEvent.setCustomData(customData);- }-- const eventsData = [serverEvent];- const eventRequest = new EventRequest(access_token, pixel_id).setEvents(- eventsData- );-- return eventRequest.execute();}}