Actualizar datos de Google Sheet

La API para el uso de Google Sheet con app.neoagent.co proporciona la funcionalidad para actualizar los datos de una hoja enviando una solicitud POST al endpoint /chat/Chatbot/UpdateGoogleSheetData.

aviso

Atención: esta API es compatible solo con chatbots tradicionales y aún no es compatible con chatbots basados en plantillas.

Endpoint

URL de la Solicitud: https://app.neoagent.co/chat/Chatbot/UpdateGoogleSheetData
Método: POST

Headers requeridos

La solicitud de la API debe incluir los siguientes encabezados:

• Authorization: <Your-Secret-Key> - string, obligatorio - La clave secreta para autenticar la solicitud de API
• Content-Type: application/json - string, obligatorio - El tipo de contenido del payload de la solicitud (debe ser application/json)

Cuerpo de la Solicitud

El cuerpo de la solicitud debe contener los siguientes parámetros:

{
// string, obligatorio - Identificador único (ID) del chatbot
"serialNumber": "3254a9d0424c4806b9ea3d0763xxxxxx",
// array de objetos, obligatorio - Lista de filas de datos a actualizar, el ID del campo es obligatorio para la actualización.
// Cada ID representa el ID de la fila de datos que debe ser actualizada y Data es un objeto dinámico que los usuarios pueden personalizar según sus necesidades.
"rows": [
{
"ID": 1,
"Data": {
"url": "XXXXX",
"name": "apple",
"productname": "iphone 16 pro max",
"price": 111
}
},
{
"ID": 2,
"Data": {
"url": "XXXXX",
"name": "xiaomi",
"productname": "xiaomi 16",
"price": 111
}
}
]
}

Parámetros

• serialNumber - string, obligatorio - Identificador único (ID) del chatbot
• rows - array de objetos, obligatorio - Lista de los datos de Google Sheet. //En cada elemento de fila, campos como URL, nombre, nombre del producto y precio son campos personalizados dinámicos. //Sus definiciones y valores son determinados por el usuario y pueden modificarse según requisitos específicos.

Ejemplos de Solicitud

JavaScript (Fetch API)

const res = await fetch('https://app.neoagent.co/chat/Chatbot/UpdateGoogleSheetData', {
  method: 'POST',
  headers: {
  "Authorization": "<Your-Secret-Key>",
  "Content-Type": "application/json"
},
  body: JSON.stringify({
  "serialNumber": "3254a9d0424c4806b9ea3d0763xxxxxx",
  "rows": [
    {
      "ID": 1,
      "Data": {
        "url": "XXXXX",
        "name": "apple",
        "productname": "iphone 16 pro max",
        "price": 111
      }
    },
    {
      "ID": 2,
      "Data": {
        "url": "XXXXX",
        "name": "xiaomi",
        "productname": "xiaomi 16",
        "price": 111
      }
    }
  ]
})
});

const data = await res.json();
console.log(data);

Python (Requests)

import requests
import json

url = 'https://app.neoagent.co/chat/Chatbot/UpdateGoogleSheetData'
headers = {
    "Authorization": "<Your-Secret-Key>",
    "Content-Type": "application/json"
}
data = {
  "serialNumber": "3254a9d0424c4806b9ea3d0763xxxxxx",
  "rows": [
    {
      "ID": 1,
      "Data": {
        "url": "XXXXX",
        "name": "apple",
        "productname": "iphone 16 pro max",
        "price": 111
      }
    },
    {
      "ID": 2,
      "Data": {
        "url": "XXXXX",
        "name": "xiaomi",
        "productname": "xiaomi 16",
        "price": 111
      }
    }
  ]
}

response = requests.post(url, headers=headers, json=data)
data = response.json()
print(data)

cURL

curl 'https://app.neoagent.co/chat/Chatbot/UpdateGoogleSheetData' \
  -X POST \
  -H 'Authorization: <Your-Secret-Key>' \
  -H 'Content-Type: application/json' \
  -d '{"serialNumber":"3254a9d0424c4806b9ea3d0763xxxxxx","rows":[{"ID":1,"Data":{"url":"XXXXX","name":"apple","productname":"iphone 16 pro max","price":111}},{"ID":2,"Data":{"url":"XXXXX","name":"xiaomi","productname":"xiaomi 16","price":111}}]}'

HTTP Raw

POST /chat/Chatbot/UpdateGoogleSheetData HTTP/1.1
Host: app.neoagent.co
Authorization: <Your-Secret-Key>
Content-Type: application/json

{
  "serialNumber": "3254a9d0424c4806b9ea3d0763xxxxxx",
  "rows": [
    {
      "ID": 1,
      "Data": {
        "url": "XXXXX",
        "name": "apple",
        "productname": "iphone 16 pro max",
        "price": 111
      }
    },
    {
      "ID": 2,
      "Data": {
        "url": "XXXXX",
        "name": "xiaomi",
        "productname": "xiaomi 16",
        "price": 111
      }
    }
  ]
}

Respuesta

La respuesta de la API será un objeto JSON con la siguiente estructura:

{
// array de números enteros - Representa los ID de las filas de datos que han sido actualizadas.
"Dati": [
1,
2
],
// string - Versión de la API
"Versione": "1.0.0",
// booleano - Estado de éxito de la operación
"Successo": true,
// entero - Código de estado HTTP
"Codice": 200,
// string - Mensaje de error, si está presente
"Messaggio": ""
}

Manejo de Errores

Si la solicitud falla, debes:

1. Verificar el código de estado HTTP por errores a nivel de red
2. Examinar los campos Code y Message en la respuesta por errores a nivel de negocio
3. El campo Message contendrá información detallada sobre el error