Pour utiliser le webservice Custom CRM et l'intégré à votre solution il faudra renseigner l'url de votre Webservice sur notre interface Graam.
Ce Webservice sera utilisé à chaque appel entrant sur votre compte.
Vous aurez la possibilité de configurer globalement ce webservice ou décider de l'utiliser uniquement pour un groupe de numéro ou de file d'attente.
Grâce à ce webservice, vous pourrez communiquer avec Graam et par exemple rediriger un appel vers une file d'attente, un agent ou bien un SVI, mais aussi partager les informations du contact afin de les afficher directement sur l'application/WebApp Graam (Nom, url de la fiche CRM)
Vous devrez au préalable créer un Webservice de votre côté prenant en entrée 2 paramètres, celui-ci sera appelé à chaque appels entrants en fonction de la configuration que vous aurez choisi au préalable.
Voici les paramètres qui seront envoyés en méthode GET vers votre Werbservice :
remote_number -> représentant le numéro du client
local_number -> représentant le numéro Graam concerné par l'appel
apikey -> permet de mettre une apikey afin d'accéder à votre webservice (non obligatoire)
ex d'appel à votre webservice : https://www.urldevotrewebservice.fr?remote_number=0601020304&local_number=0186534900&apikey=votreapikey
Votre webservice devra retourner ce type de retour à notre système, il est composé d'un tableau "caller_info" qui contient les informations concernant le contact.
Infos du contact :
full_name : nom du contact qui sera affiché sur l'application
caller_profile_url : Lien qui sera disponible sur l'application en cliquant sur le nom
Ex :
{
caller_info: {
full_name: "Nom de la personne",
caller_profile_url: "URL de la fiche CRM"}
}
Etape 1 : Connectez-vous à l'interface Graam, allez dans le menu "CRM & Outils" puis dans la section Entreprise CRM et cliquez sur le bouton "+" présent en bas à droite de la page.
Etape 2 : Une fenêtre vous proposant de choisir votre CRM s'ouvrira, cliquez sur l'icône "customcrm".
Etape 3 : Vous n'avez plus qu'à renseigner l'url de votre webservice préalablement crée, vous avez possibilité de renseigner une api key afin de sécuriser votre webservice (l'api key est optionnel si vous choisissez de ne pas la rendre obligatoire sur votre webservice)
Un bouton "Service de Test" est disponible afin de vérifier que la connexion fonctionne correctement.
Pour gérer les Callbacks Web lorsqu'un appel est lancé ou terminé veuillez ajouter les urls des webservices sur la page ci-dessous, un POST sera envoyé à chaque évènement.
Vous retrouverez ci-contre un exemple de Callback envoyé pour un évènement d'appel, il sera envoyé en HTTP POST avec un payload json :
{
“answer_time”: “2016-11-22 18:31:19",
“onhold_duration”: 0,
“hangup_time”: “2016-11-22 18:46:21”,
“client_number”: “0033177172010”,
“start_time”: “2016-11-22 18:31:06”,
“com_duration”: 52,
“call_id”: “wecontact-0/20161122183105-sip/4907",
“is_outgoing”: 0,
“agents”: [“agent1@graam.com”, “agent2@graam.com”],
“our_number”: “0033188877776",
“wephone_call”: {
“answer_time”: “2016-11-22 18:31:19”,
“onhold_duration”: 0,
“hangup_time”: “2016-11-22 18:46:21",
“client_number”: “0033177172010",
“start_time”: “2016-11-22 18:31:06",
“com_duration”: 52,
“call_id”: “wecontact-0/20161122183105-sip/4907”,
“is_outgoing”: 0,
“agents”: [“agent1@graam.com”, “agent2@graam.com”],
“our_number”: “0033188877776”
}
}