Hooks
Set hooks
You can define custom hooks to be executed on various events.
Thanks to this you will be able to interact with your application when a survey appears, or execute some custom code when a survey is submitted.
You can define hooks on initSdk()
and startSurvey()
commands. Hooks are all optional.
Available hooks are:
onSurveyShowed
: called when a survey is showedonSurveyStarted
: called when a survey is startedonQuestionReplied
: called when a question is repliedonSurveyCompleted
: called when a survey is completedonSurveyHidden
: called when a survey is hiddenonReady
: called when the SDK is ready (Only available oninitSdk()
)
Set hooks on SDK init
initSdk(
"<android-channel-id>",
"<ios-channel-id>",
"<user-id>",
{
'isConnected': false,
'age': 29,
'product': 'iPhone 13',
'email': '[email protected]',
},
{
version: "1.0.0",
onReady: (payload: any) => {
console.log("onReady", payload);
},
}
);
Set hooks on survey start
startSurvey(
"<survey-id>",
"<allowMultipleResponses>",
"<properties>",
"<ignoreSurveyStatus>",
{
version: "1.0.0",
onSurveyShowed: (payload: any) => {
console.log("onSurveyShowed", payload);
},
}
);
Payload types
onSurveyShowed: {
channel: {
id: string,
type: "android" | "ios"
},
survey: {
id: string,
survey_position: "center-left" | "center-center" | "center-right" | "bottom-left" | "bottom-center" | "bottom-right",
survey_size: 25 | 50 | 75 | 100 | 125 | 150,
survey_format: "conversational" | "cards",
},
response: {
id: string,
items: {
question: {
id: string;
title: string;
type: "text" | "video";
url: string;
};
answer: {
fields: {
type: "string" | "number" | "boolean" | "none" | "time" | "url";
},
text: string;
number: number;
boolean: boolean;
time: Date;
url: string;
}[] | undefined;
replied_at: Date | undefined;
}[];
},
user: {
anonymous_id: string,
user_id: string,
}
}
onSurveyStarted: {
channel: {
id: string,
type: "android" | "ios"
},
survey: {
id: string,
survey_position: "center-left" | "center-center" | "center-right" | "bottom-left" | "bottom-center" | "bottom-right",
survey_size: 25 | 50 | 75 | 100 | 125 | 150,
survey_format: "conversational" | "cards",
},
response: {
id: string,
},
user: {
anonymous_id: string,
user_id: string,
}
}
onQuestionReplied: {
channel: {
id: string,
type: "android" | "ios"
},
survey: {
id: string,
survey_position: "center-left" | "center-center" | "center-right" | "bottom-left" | "bottom-center" | "bottom-right",
survey_size: 25 | 50 | 75 | 100 | 125 | 150,
survey_format: "conversational" | "cards",
},
response: {
id: string,
status: "started" | "ended" | "closed" | "interrupted"
question: {
id: string;
title: string;
type: "text" | "video";
url: string;
};
answer: {
fields: {
type: "string" | "number" | "boolean" | "none" | "time" | "url";
},
text: string;
number: number;
boolean: boolean;
time: Date;
url: string;
};
items: {
question: {
id: string;
title: string;
type: "text" | "video";
url: string;
};
answer: {
fields: {
type: "string" | "number" | "boolean" | "none" | "time" | "url";
},
text: string;
number: number;
boolean: boolean;
time: Date;
url: string;
}[] | undefined;
replied_at: Date | undefined;
}[];
},
user: {
anonymous_id: string,
user_id: string,
}
}
onSurveyCompleted: {
channel: {
id: string,
type: "android" | "ios"
},
survey: {
id: string,
survey_position: "center-left" | "center-center" | "center-right" | "bottom-left" | "bottom-center" | "bottom-right",
survey_size: 25 | 50 | 75 | 100 | 125 | 150,
survey_format: "conversational" | "cards",
},
response: {
id: string,
items: {
question: {
id: string;
title: string;
type: "text" | "video";
url: string;
};
answer: {
fields: {
type: "string" | "number" | "boolean" | "none" | "time" | "url";
},
text: string;
number: number;
boolean: boolean;
time: Date;
url: string;
}[] | undefined;
replied_at: Date | undefined;
}[];
},
user: {
anonymous_id: string,
user_id: string,
}
}
onSurveyHidden: {
channel: {
id: string,
type: "android" | "ios"
},
survey: {
id: string,
survey_position: "center-left" | "center-center" | "center-right" | "bottom-left" | "bottom-center" | "bottom-right",
survey_size: 25 | 50 | 75 | 100 | 125 | 150,
survey_format: "conversational" | "cards",
},
response: {
id: string,
hide_reason: "started" | "ended" | "closed" | "interrupted",
items: {
question: {
id: string;
title: string;
type: "text" | "video";
url: string;
};
answer: {
fields: {
type: "string" | "number" | "boolean" | "none" | "time" | "url";
},
text: string;
number: number;
boolean: boolean;
time: Date;
url: string;
}[] | undefined;
replied_at: Date | undefined;
}[];
},
user: {
anonymous_id: string,
user_id: string,
}
}
onReady: {
channel: {
id: string,
type: "android" | "ios"
},
user: {
anonymous_id: string,
user_id: string,
}
}