Configuring Webhooks for RecruitApp.ai Events

RecruitApp.ai supports webhooks for various actions and events, allowing you to automate workflows and stay updated in real-time. Below is a detailed explanation of the available webhook triggers and their use cases.

What Actions and Events Can Trigger a Webhook in RecruitApp.ai?

RecruitApp.ai provides webhooks for the following actions and events:

1. new_icard

• Trigger: Whenever a new interest card is submitted.
• Use Case: Notify your team or integrate with a CRM to follow up with new applicants as soon as they express interest.
  
  

2. rescheduled_icard

• Trigger: When an existing interest card is rescheduled for a new hiring event.
• Use Case: Keep track of rescheduling activity and update your records or notify hiring managers automatically.
  
  

3. kiosk_contact

• Trigger: When a contact is generated through a kiosk app at an outreach or recruiting event.
• Use Case: Automatically capture and process leads gathered at recruitment and outreach events.
  
  

4. event_report

• Trigger: When a hiring event ends.
• Use Case: Generate post-event reports and analyze the success of your hiring efforts. This webhook will include all interest cards related to the event.
  
  

5. attended_event

• Trigger: Provides a complete list of applicants who successfully attended a hiring event, along with event details.
• Use Case: Follow up with attendees or update your records with attendance data.
  
  

6. missed_event

• Trigger: Sends a complete list of applicants who missed their hiring event appointment, along with event details.
• Use Case: Automate reminders, re-engagement campaigns, or flag no-shows for further action.
  
  

7. archived_icard

• Trigger: Sends a list of interest cards when they are archived. This occurs 30 days after a hiring event if the applicants have not been re-engaged or booked for a future event.
• Use Case: Review archived interest cards and take action to reactivate or analyze past engagement efforts.

How Do I Configure These Webhooks?

1. Log in to your RecruitApp.ai account.
   
   
2. Navigate to Settings > Integrations > Webhooks.
   
   
3. Click Add Webhook and:
   • Choose the event or action you want to configure (e.g., new_icard, event_report).
     
     
   • Provide the destination endpoint (URL) for the webhook.
     
     
4. Save the webhook.
   
   

You can configure multiple webhooks for the same action, provided each points to a unique endpoint.

Can I Test My Webhooks?

Yes! RecruitApp.ai allows you to test your webhook setup before going live. During testing:

• A sample payload is sent to your endpoint for the chosen action.
  
  
• The system verifies that your server is properly configured to validate the signature and process the data.

Best Practices for Webhook Configuration

• Secure Your Endpoint: Use HTTPS and implement signature verification to ensure data integrity.
  
  
• Monitor Activity: Use the RecruitApp.ai dashboard to track the status of your webhooks.
  
  
• Handle Errors Gracefully: Ensure your endpoint can return a 200 OK status and respond to retries if needed.