Webhook Actions

These are all of the possible Webhook Actions that you could receive from Truepic Vision and a description of what that action means.

Use these action names to select which Truepic Vision webhook events your endpoint receives and to identify events in delivered payloads.

Receive only what you need: In Settings > Webhooks, select the events your integration handles. For example, select ACTION_STATUS_READY_FOR_REVIEW if you only need to know when an inspection is ready for review. With no event selection, the webhook receives every event for its team. See Webhook Setup to configure or change your selection, including through the API's enabled_events field.

The table describes commonly documented actions. Additional selectable names appear below it; consult the webhook API reference for the current enabled_events values. Event names in delivered payloads follow the webhook's configured API version.

NameDescription
ACTION_STATUS_STARTEDThe customer has downloaded AND opened the app.
ACTION_STATUS_IN_PROGRESSThe customer has either taken at least one picture OR answered one question.
ACTION_STATUS_READY_FOR_REVIEWThe customer has submitted the inspection for review OR the inspection has expired with at least one image captured or one question answered.
ACTION_INSPECTION_CLOSEDThe inspection has been closed by the organization.
ACTION_INSPECTION_CANCELEDThe inspection has been canceled by the organization.
ACTION_PHOTO_VERIFICATION_PASSEDThe image passed all tests.
ACTION_PHOTO_VERIFICATION_FAILEDThe image failed at least one test.
ACTION_PHOTO_VERIFICATION_WARNThe image had at least one test with a warning.
ACTION_PHOTO_DELETEDThe customer deleted a picture.
ACTION_QUESTION_ANSWEREDThe customer answered a question.
ACTION_QUESTION_ANSWER_DELETEDThe customer deleted an answer to a question.
ACTION_MESSAGE_WELCOME_TEXTVision sent the customer a text using the “new request” message template.
ACTION_MESSAGE_REMINDER_TEXTVision sent the customer a text using the “reminder to start” message template.
ACTION_MESSAGE_REQUEST_TEXTVision sent the customer a text using the “request more” message template.
ACTION_MESSAGE_AUTO_REMINDER_TEXTVision sent the customer a text using the “reminder to start” message template.
ACTION_MESSAGE_AUTO_REPLY_EMAILVision sent the customer an email using the “auto-reply” message template.
ACTION_MESSAGE_AUTO_REPLY_TEXTVision sent the customer a text using the “auto-reply” message template.
ACTION_MESSAGE_AGENT_REPLY_TEXTThe dashboard user sent the customer a text message.
ACTION_MESSAGE_WELCOME_EMAILVision sent the customer an email using the “new request” message template.
ACTION_MESSAGE_REMINDER_EMAILVision sent the customer an email using the “reminder to start” message template.
ACTION_MESSAGE_REQUEST_EMAILVision sent the customer an email using the “request more” message template.
ACTION_MESSAGE_AUTO_REMINDER_EMAILVision sent the customer an email using the “reminder to start” message template.
ACTION_MESSAGE_EMAIL_REPLYThe customer replied directly to the email.
ACTION_MESSAGE_EMAIL_BOUNCEDVision sent the customer an email. The email bounced and did not reach the customer. Most commonly, the email address was invalid.
ACTION_MESSAGE_EMAIL_DROPPEDVision did not send email to customer, because the email had previously bounced.
ACTION_MESSAGE_EMAIL_DROPPED_VIA_UNSUBSCRIBEVision did not send email to customer, because the customer unsubscribed from emails.
ACTION_EMAIL_UNSUBSCRIBEDThe customer unsubscribed from all Truepic emails.
ACTION_EMAIL_RESUBSCRIBEDThe customer resubscribed to Truepic emails.
ACTION_CONSUMER_REPLYThe customer replied to the text message.
ACTION_PDF_READYThe PDF report is ready for download. Download it from operation.result.url in the webhook payload; do not call the export endpoint again. See Export inspection PDFs.
ACTION_PDF_FAILEDThe PDF report failed to generate. Inspect the associated operation result for the error before retrying the export.

Additional selectable event names

The webhook API's enabled_events list also includes these action names. Select them only if your integration needs them; this list does not describe their payloads or triggering conditions.

  • Inspection and status: ACTION_INSPECTION_CREATED, ACTION_INSPECTION_SCHEDULED, ACTION_INSPECTION_RESCHEDULED, ACTION_STATUS_PROCESSING.
  • Text messages: ACTION_MESSAGE_FINISH_REMINDER_TEXT, ACTION_MESSAGE_AUTO_FINISH_REMINDER_TEXT, ACTION_MESSAGE_INSPECTION_FINISHED_TEXT, ACTION_MESSAGE_RECEIVED, ACTION_MESSAGE_FAILED, ACTION_MESSAGE_UNDELIVERED, ACTION_MESSAGE_TEXT_DROPPED_VIA_UNSUBSCRIBE.
  • Email: ACTION_MESSAGE_FINISH_REMINDER_EMAIL, ACTION_MESSAGE_AUTO_FINISH_REMINDER_EMAIL, ACTION_MESSAGE_INSPECTION_FINISHED_EMAIL, ACTION_MESSAGE_EMAIL_RECEIVED, ACTION_MESSAGE_EMAIL_OPENED, ACTION_MESSAGE_EMAIL_SPAM_REPORTED.
  • Other: ACTION_APP_OPENED, ACTION_AI_ANALYSIS_FAILED.

For API-based configuration, see Create a webhook and Update a webhook. The API accepts both legacy v2 and current v3 event spellings when you configure enabled_events; the delivered action names follow the webhook's configured API version.


Did this page help you?