Webhook

Lorsqu’un événement se produit sur gextra nous appelons l’url d’antipodes. Cette url reçoit un JSON en POST. Tout se passe comme si l’appel était fait ainsi :

curl -X POST https://xxxxxx \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
--data '{...}'

Quand le webhook est-il appelé ?

Le webhook n’est PAS appelé à la création d’un contact / candidature / survey via les endpoints POST d’antipodes (commercial/create, survey/create, announcement/postuler). À la création, antipodes possède déjà toutes les données puisque c’est lui qui les envoie. Le webhook est appelé uniquement lorsqu’un administrateur gextra effectue une action interne sur l’entrée. C’est donc un mécanisme de mise à jour, pas de confirmation de réception.

Déclencheurs par type d’entrée

Entrée (URL antipodes → gextra)	Action interne qui déclenche le webhook	Champ principal de qualification
`commercial/create`	Édition de la démarche commerciale (résultat, motif…)	`resultat`
`commercial/create`	Ajout d’une action (appel, visite, envoi doc…)	`actionType` + `resultat`
`commercial/create`	Affectation d’un résident à la démarche (admission)	`resultat = commercial.resultat.realisee`
`survey/create` (type contact / survey / complaint)	Traitement du message par un admin (bouton “done”)	`done`
`announcement/postuler`	Changement de statut de la candidature par un admin	`status`

En mode test (email test@antipodes-m.com ou query string ?test=1), le webhook est également appelé immédiatement à la création pour vérifier le bon fonctionnement côté antipodes.

Liste des différents évenements

Contact :
- Message traitée
- Contact établi (téléphone, etc.)
- Visite réalisée
- Admission réalisée
- Ne donnera pas suite
Satisfaction :
- Message traitée
Réclamation :
- Message traitée
Candidatures :
- Candidature consultée
- Déjà contacté
- Reçu en entretien
- Candidature non retenue
- Candidature retenue
Commercial :
- Prise d’information (tel /email)
- Visite d’etablissement
- Envoi de documentation
- Autre

Exemple de JSON envoyé :

Contact data Champs d’un contact :

done (BOOLEAN): Message traité
contact (BOOLEAN): Contact établi (téléphone, etc.)
visite (BOOLEAN): Visite réalisée
admission (BOOLEAN): Admission réalisée
quit (BOOLEAN): Ne donnera pas suite
doneComment (TEXT): Commentaire

// "type" vaudra :
// "survey.type.contact":
{
  id: 23435,
  gclId: 'EAIaIQobChMI1pywgp-H-QIV5o5oCR2Gbw1eEAAYAiAAEgL3WPD_BwE',
  customId: null,
  type: 'survey.type.contact',
  done: false,
  doneComment: 'test',
  contact: false,
  visite: false,
  admission: false,
  quit: false,
}

// "type" vaudra :
// "survey.type.survey" &&
// "survey.type.complaint" :
{
  id: 23435,
  gclId: 'EAIaIQobChMI1pywgp-H-QIV5o5oCR2Gbw1eEAAYAiAAEgL3WPD_BwE',
  customId: null,
  type: 'survey.type.survey',
  done: false,
  doneComment: 'test',
}

Candidature data Pour les candidatures, le champ de qualification côté gextra est status (pas resultat).

// status vaudra :
// "postule.status.seen": Candidature consultée
// "postule.status.contact": Déjà contacté
// "postule.status.entretien": Reçu en entretien
// "postule.status.ko": Candidature non retenue
// "postule.status.ok": Candidature retenue
// "postule.status.unshown": Ne s'est pas présenté à l'entretien
// "postule.status.nonews": Ne donne plus de nouvelle
// "postule.status.hire": Recruté(e)

{
    "id": 9470,
    "type": "postuler",
    "customId": null,
    "status": "postuler.status.seen"
}

Commercial data (contact commercial) Le champ de qualification est resultat. Il reste null tant qu’aucun admin gextra n’a édité la démarche : c’est attendu. Les 3 valeurs possibles sont :

commercial.resultat.refuse : Admission refusée
commercial.resultat.nosuite : Ne donnera pas de suite
commercial.resultat.realisee : Admission réalisée

{
    "id": "1",
    "customId": 1,
    "sejourType": "commercial.sejourType.permanent",
    "type": "commercial.type.email",
    "commentBy": "commentaire sur le contact etabli",
    "resultat": "commercial.resultat.refuse",
    "motif": "commercial.motif.dossierrefuse",
    "actionType": "commercialaction.type.autre",
    "comment": "",
    "dateFirstContact": "",
    "dateAction": "",
    "commentAction": "",
    "dureeAppel": ""
}

Introduction

Endpoints API

Endpoints Gextra

Endpoints Reservation

Quand le webhook est-il appelé ?

Déclencheurs par type d’entrée

Liste des différents évenements

Exemple de JSON envoyé :

​Quand le webhook est-il appelé ?

​Déclencheurs par type d’entrée

​Liste des différents évenements

​Exemple de JSON envoyé :

Quand le webhook est-il appelé ?

Déclencheurs par type d’entrée

Liste des différents évenements

Exemple de JSON envoyé :