Integración con webservice de Salesforce

Integración de Oct8ne con Salesforce con Webservice

Este documento hace referencia a la integración de Oct8ne con Salesforce a través de un webservice. Si se desea integrar de forma directa, solo tiene que activar el módulo desde el panel de Oct8ne, en el apartado de integraciones.


1. Autenticación (POST)


 Para poder insertar/actualizar casos en Salesforce primero es necesaria una autentificación en Salesforce mediante una petición Post y recuperar el access_token . Está petición tendrá la siguiente estructura:

  1. URL endpoint 

https://login.salesforce.com/services/oauth2/token 

Parámetros para la petición

Estos son los valores que hay que incluir en la petición para obtener la api key

Quote

{

   "username":"email@oct8ne.com",

   "password": "*******",

   "grant_type":"password",

   "client_id":"XXXXXXXX",

   "client_secret":" XXXXXXXX "

}


Respuesta correcta

La respuesta a una petición correcta será la siguiente:


Quote

{

   "acces_token":"XXXXX",

   "instance_url": "https://XXX.salesforce.com",

   "id":"XXXXX",

   "token_type":"Bearer",

   "issued_at":"XXXXX",

   "signature":"XXXXX",

}


Se recibirá el access_token que es lo que tendremos que insertar en las peticiones de inserción de casos.

También como parámetro se recibirá la url (en el parámetro instance_url) para poder crear los casos.



2. Crear casos desde Oct8ne (POST)


Para hacer la petición tendremos dos endpoints:

  1. URL endpoint 


instance_url obtenida en la petición de autenticación 


Parámetros para la petición

En el Header de la petición debemos incluir el access_token de la siguiente forma:

Authorization: Bearer(espacio) + access_token (obtenido en la petición anterior) 


Quote

{

   "Agent" : "Email del agente que ha atendido la sesión",

   "CreatedAt" : "fecha de creación de la sesión de oct8ne",

   "Subject" : "Titulo del caso",

   "Description" : "Descripción más detallada de las necesidades del cliente",

   "ClientEmail" : "Email",

   "ClientName" : "Nombre",

   "Location" : "Localización del cliente",

   "Tags" : "Tags añadidos desde Oct8ne separados por comas",

   "TranscriptionId" : "Id de la transcripción",

   "Transcripcion":"transcripción completa en html",

   "Url": "url desde donde el cliente ha iniciado la conversación" 

}





Ejemplo de petición completa 

Ejemplo.


Quote

{

   "Agent" : "email@oct8ne.com",

   "CreatedAt" : "2021-05-07 16:30:28.693",

   "Subject" : "Chat de Oct8ne",

   "Description" : "Descripción más detallada de las necesidades del cliente",

   "ClientEmail" : "cliente@gmail.com",

   "ClientName" : "Joan",

   "Location" : "Barcelona, ES",

   "Tags" : "Oct8ne,Oct8ne_Sale",

   "TranscriptionId" : "25019",

   "Transcripcion":"<br><br><p><h2>Transcription</h2></p><p><b>Id:</b> 25019</p><p><b>Record Details:</b> <a href='http://localhost:4700/NewDashboard/Records/InteractionDetails?tokenSession=25019-ADE73627724F14A0072D3489A2FC6C87&sessionSummaryId=25019&recordDetails=true&license=883AD255BBCC9AAABAA4214ACB2BF62E&edition=0'>LINK</a> -- <b>Country:</b></> Barcelona,ES</p><p><b>URL:</b> <a href='http://localhost:5100/prestashop/9-art'>http://localhost:5100/prestashop/9-art</a></p><p><b>EMAIL:</b> cliente@gmail.com</p><p><h3>Chats</h3></p><b> 18:42:28 (UTC +0) Product: (Test) The bluebell</b><br/><img src='http://backoffice.oct8ne.com/api/img/catalog/s/s1.jpg' width='125px' height='Auto' alt='(Test) The bluebell' /> <br/><b> 18:45:28 (UTC +0) Product: (Test) The bluebell</b><br/><img src='http://backoffice.oct8ne.com/api/img/catalog/s/s1.jpg' width='125px' height='Auto' alt='(Test) The bluebell' /> <br/><b> 18:45:42 (UTC +0) Product: (Test) The bluebell</b><br/><img src='http://backoffice.oct8ne.com/api/img/catalog/s/s1.jpg' width='125px' height='Auto' alt='(Test) The bluebell' /> <br/>",

   "Url": "https://www.oct8ne.com/" 

}


  1. Respuesta correcta:



Quote

{

    "errors":null,

    "id":"XXXXXXX",

    "success":true

}



  1. Respuesta incorrecta



Quote

{

    "errors":"descripción del error",

    "id" : null,

    "success":false

}


    

    

    







    • Related Articles

    • API Oct8ne de integración con CSM a medida

      Documentación del API Oct8ne Versión del API 2.4 (Octubre 2024 / rev05) Índice de contenidos 1. Introducción 2. Arquitectura 3. Vista general 3.1. Descargar e instalar plugin/extensión 3.2. Registro como desarrollador y activación de la plataforma ...

    • Integración de Oct8ne con Google Analytics 4

      Integración de Oct8ne con Google Analytics 4 Introducción Oct8ne permite la integración directa con Google Analytics versión 4 (GA4) a través del envío de eventos. Estos aportan información vital sobre las interacciones que se realizan dentro de ...

    • Como integrar el buscador de Doofinder con Oct8ne

      Oct8ne permite la integración del motor de búsqueda con Doofinder, dentro del panel de Magento 2. Primero de todo, debes asegurar que tu Doofinder esta CORRECTAMENTE instalado y funcionando en tu tienda de MAGENTO2. Una vez tu entorno este bien ...

    • No recibo mensajes de Instagram, pero la integración se hizo correctamente.

      En ocasiones puede estar las cuentas vinculadas de Facebook e Instagram, pero en la página de Facebook no está marcado el switch que permite la gestión de mensajes de Instagram. Si no sabéis a lo que me refiero os pongo un breve recordatorio… 1. ...

    • Como configurarOct8ne con Doofinder en Prestashop

      Oct8ne permite la integración del motor de búsqueda con Doofinder, dentro del panel de Prestashop. Para que quede configurado correctamente se deben realizar estos sencillos pasos. Antes de todo, como REQUISITO, es indispensable que Doofinder esté ...