{
  "info": {
    "name": "Totum Connect API V3",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
    "description": "Colección V3 de la API de WhatsApp de Totum Connect. Incluye un ejemplo de envío a contactos con teléfono y otro a contactos sin teléfono mediante BSUID."
  },
  "item": [
    {
      "name": "Enviar Mensaje",
      "request": {
        "method": "POST",
        "url": {
          "raw": "https://totum-connect.com/api/messages/text",
          "query": null,
          "protocol": "https",
          "host": [
            "totum-connect",
            "com"
          ],
          "port": null,
          "path": [
            "api",
            "messages",
            "text"
          ]
        },
        "description": "",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json",
            "disabled": false,
            "description": null
          },
          {
            "key": "X-TOTUM-KEY",
            "value": "xxxxxxxxxxxxxx",
            "disabled": false,
            "description": null
          }
        ],
        "body": {
          "mode": "raw",
          "disabled": false,
          "raw": "{\"to\":\"5215513447932\",\"message\":\"Hola desde Totum\"}"
        },
        "auth": null
      },
      "protocolProfileBehavior": {
        "followRedirects": false,
        "followOriginalHttpMethod": false,
        "followAuthorizationHeader": false
      },
      "response": []
    },
    {
      "name": "Enviar Mensaje por BSUID",
      "request": {
        "method": "POST",
        "url": {
          "raw": "https://totum-connect.com/api/messages/text",
          "query": null,
          "protocol": "https",
          "host": [
            "totum-connect",
            "com"
          ],
          "port": null,
          "path": [
            "api",
            "messages",
            "text"
          ]
        },
        "description": "Ejemplo para contactos que no tienen número de teléfono. En el campo `to`, usa el identificador recibido en `contact.from_user_id` en el webhook. Totum lo transforma al campo `recipient` requerido por Meta. Sustituye el identificador de ejemplo por el BSUID real del contacto.",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json",
            "disabled": false,
            "description": null
          },
          {
            "key": "X-TOTUM-KEY",
            "value": "xxxxxxxxxxxxxx",
            "disabled": false,
            "description": null
          }
        ],
        "body": {
          "mode": "raw",
          "disabled": false,
          "raw": "{\"to\":\"CO.1234567890123456\",\"message\":\"Hola desde Totum usando el identificador de WhatsApp\"}"
        },
        "auth": null
      },
      "protocolProfileBehavior": {
        "followRedirects": false,
        "followOriginalHttpMethod": false,
        "followAuthorizationHeader": false
      },
      "response": []
    },
    {
      "name": "Enviar Imagen",
      "request": {
        "method": "POST",
        "url": {
          "raw": "https://totum-connect.com/api/messages/image",
          "query": null,
          "protocol": "https",
          "host": [
            "totum-connect",
            "com"
          ],
          "port": null,
          "path": [
            "api",
            "messages",
            "image"
          ]
        },
        "description": "",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json",
            "disabled": false,
            "description": null
          },
          {
            "key": "X-TOTUM-KEY",
            "value": "xxxxxxxxxxxxxx",
            "disabled": false,
            "description": null
          }
        ],
        "body": {
          "mode": "raw",
          "disabled": false,
          "raw": "{\"to\":\"5215513447932\",\"image_url\":\"https://solventia.com.mx/wp-content/uploads/2025/04/logo-site-solventia.png\",\"caption\":\"Mira esta imagen \\ud83d\\ude0e\"}"
        },
        "auth": null
      },
      "protocolProfileBehavior": {
        "followRedirects": false,
        "followOriginalHttpMethod": false,
        "followAuthorizationHeader": false
      },
      "response": []
    },
    {
      "name": "Enviar Documento",
      "request": {
        "method": "POST",
        "url": {
          "raw": "https://totum-connect.com/api/messages/document",
          "query": null,
          "protocol": "https",
          "host": [
            "totum-connect",
            "com"
          ],
          "port": null,
          "path": [
            "api",
            "messages",
            "document"
          ]
        },
        "description": "",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json",
            "disabled": false,
            "description": null
          },
          {
            "key": "X-TOTUM-KEY",
            "value": "xxxxxxxxxxxxxx",
            "disabled": false,
            "description": null
          }
        ],
        "body": {
          "mode": "raw",
          "disabled": false,
          "raw": "{\"to\":\"5215513447932\",\"document_url\":\"https://solventia.com.mx/temporal/documento.doc\",\"caption\":\"Aqui est\\u00e1 el documento\",\"filename\":\"acum.xlsx\"}"
        },
        "auth": null
      },
      "protocolProfileBehavior": {
        "followRedirects": false,
        "followOriginalHttpMethod": false,
        "followAuthorizationHeader": false
      },
      "response": []
    },
    {
      "name": "Enviar Audio",
      "request": {
        "method": "POST",
        "url": {
          "raw": "https://totum-connect.com/api/messages/audio",
          "query": null,
          "protocol": "https",
          "host": [
            "totum-connect",
            "com"
          ],
          "port": null,
          "path": [
            "api",
            "messages",
            "audio"
          ]
        },
        "description": "",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json",
            "disabled": false,
            "description": null
          },
          {
            "key": "X-TOTUM-KEY",
            "value": "xxxxxxxxxxxxxx",
            "disabled": false,
            "description": null
          }
        ],
        "body": {
          "mode": "raw",
          "disabled": false,
          "raw": "{\"to\":\"5215513447932\",\"audio_url\":\"https://solventia.com.mx/temporal/s3.mp3\",\"mime_type\":\"audio/mpeg\"}"
        },
        "auth": null
      },
      "protocolProfileBehavior": {
        "followRedirects": false,
        "followOriginalHttpMethod": false,
        "followAuthorizationHeader": false
      },
      "response": []
    },
    {
      "name": "Enviar Video",
      "request": {
        "method": "POST",
        "url": {
          "raw": "https://totum-connect.com/api/messages/video",
          "query": null,
          "protocol": "https",
          "host": [
            "totum-connect",
            "com"
          ],
          "port": null,
          "path": [
            "api",
            "messages",
            "video"
          ]
        },
        "description": "",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json",
            "disabled": false,
            "description": null
          },
          {
            "key": "X-TOTUM-KEY",
            "value": "xxxxxxxxxxxxxx",
            "disabled": false,
            "description": null
          }
        ],
        "body": {
          "mode": "raw",
          "disabled": false,
          "raw": "{\"to\":\"5215513447932\",\"video_url\":\"https://solventia.com.mx/temporal/vid.mp4\"}"
        },
        "auth": null
      },
      "protocolProfileBehavior": {
        "followRedirects": false,
        "followOriginalHttpMethod": false,
        "followAuthorizationHeader": false
      },
      "response": []
    },
    {
      "name": "Enviar Ubicación",
      "request": {
        "method": "POST",
        "url": {
          "raw": "https://totum-connect.com/api/messages/location",
          "query": null,
          "protocol": "https",
          "host": [
            "totum-connect",
            "com"
          ],
          "port": null,
          "path": [
            "api",
            "messages",
            "location"
          ]
        },
        "description": "",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json",
            "disabled": false,
            "description": null
          },
          {
            "key": "X-TOTUM-KEY",
            "value": "xxxxxxxxxxxxxx",
            "disabled": false,
            "description": null
          }
        ],
        "body": {
          "mode": "raw",
          "disabled": false,
          "raw": "{\"to\":\"5215513447932\",\"latitude\":\"19.340529594178935\",\"longitude\":\"-99.1154702340834\",\"name\":\"Solventia Software Oficinas Centrales\",\"address\":\"3ra Privada de Guerrero 12, Coyoac\\u00e1n, M\\u00e9xico\"}"
        },
        "auth": null
      },
      "protocolProfileBehavior": {
        "followRedirects": false,
        "followOriginalHttpMethod": false,
        "followAuthorizationHeader": false
      },
      "response": []
    },
    {
      "name": "Enviar interaccion Botones",
      "request": {
        "method": "POST",
        "url": {
          "raw": "https://totum-connect.com/api/messages/interactive",
          "query": null,
          "protocol": "https",
          "host": [
            "totum-connect",
            "com"
          ],
          "port": null,
          "path": [
            "api",
            "messages",
            "interactive"
          ]
        },
        "description": "",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json",
            "disabled": false,
            "description": null
          },
          {
            "key": "X-TOTUM-KEY",
            "value": "xxxxxxxxxxxxxx",
            "disabled": false,
            "description": null
          }
        ],
        "body": {
          "mode": "raw",
          "disabled": false,
          "raw": "{\"to\":\"5215513447932\",\"interactive\":{\"type\":\"button\",\"body\":{\"text\":\"\\u00bfC\\u00f3mo calificar\\u00edas el servicio?\"},\"action\":{\"buttons\":[{\"type\":\"reply\",\"reply\":{\"id\":\"excelente\",\"title\":\"Excelente\"}},{\"type\":\"reply\",\"reply\":{\"id\":\"bueno\",\"title\":\"Bueno\"}}]}}}"
        },
        "auth": null
      },
      "protocolProfileBehavior": {
        "followRedirects": false,
        "followOriginalHttpMethod": false,
        "followAuthorizationHeader": false
      },
      "response": []
    },
    {
      "name": "Enviar interaccion Listas",
      "request": {
        "method": "POST",
        "url": {
          "raw": "https://totum-connect.com/api/messages/interactive",
          "query": null,
          "protocol": "https",
          "host": [
            "totum-connect",
            "com"
          ],
          "port": null,
          "path": [
            "api",
            "messages",
            "interactive"
          ]
        },
        "description": "",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json",
            "disabled": false,
            "description": null
          },
          {
            "key": "X-TOTUM-KEY",
            "value": "xxxxxxxxxxxxxx",
            "disabled": false,
            "description": null
          }
        ],
        "body": {
          "mode": "raw",
          "disabled": false,
          "raw": "{\"to\":\"5215513447932\",\"interactive\":{\"type\":\"list\",\"header\":{\"type\":\"text\",\"text\":\"Totum Connect\"},\"body\":{\"text\":\"Selecciona una opci\\u00f3n\"},\"footer\":{\"text\":\"Powered by Totum\"},\"action\":{\"button\":\"Ver opciones\",\"sections\":[{\"title\":\"Servicios\",\"rows\":[{\"id\":\"ventas\",\"title\":\"Ventas\",\"description\":\"Hablar con ventas\"},{\"id\":\"soporte\",\"title\":\"Soporte\",\"description\":\"Abrir ticket\"}]}]}}}"
        },
        "auth": null
      },
      "protocolProfileBehavior": {
        "followRedirects": false,
        "followOriginalHttpMethod": false,
        "followAuthorizationHeader": false
      },
      "response": []
    },
    {
      "name": "Enviar interaccion CTA",
      "request": {
        "method": "POST",
        "url": {
          "raw": "https://totum-connect.com/api/messages/interactive",
          "query": null,
          "protocol": "https",
          "host": [
            "totum-connect",
            "com"
          ],
          "port": null,
          "path": [
            "api",
            "messages",
            "interactive"
          ]
        },
        "description": "",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json",
            "disabled": false,
            "description": null
          },
          {
            "key": "X-TOTUM-KEY",
            "value": "xxxxxxxxxxxxxx",
            "disabled": false,
            "description": null
          }
        ],
        "body": {
          "mode": "raw",
          "disabled": false,
          "raw": "{\"to\":\"5215513447932\",\"interactive\":{\"type\":\"cta_url\",\"body\":{\"text\":\"Totum Connect \"},\"action\":{\"name\":\"cta_url\",\"parameters\":{\"display_text\":\"Visitar P\\u00e1gina Web\",\"url\":\"https://totum-connect.com\"}}}}"
        },
        "auth": null
      },
      "protocolProfileBehavior": {
        "followRedirects": false,
        "followOriginalHttpMethod": false,
        "followAuthorizationHeader": false
      },
      "response": []
    },
    {
      "name": "Enviar FLOW",
      "request": {
        "method": "POST",
        "url": {
          "raw": "https://totum-connect.com/api/messages/interactive",
          "query": null,
          "protocol": "https",
          "host": [
            "totum-connect",
            "com"
          ],
          "port": null,
          "path": [
            "api",
            "messages",
            "interactive"
          ]
        },
        "description": "Envía un WhatsApp FLOW publicado en Meta. Sustituye flow_id por el ID del Flow en Meta y flow_token por un token único para rastrear la respuesta.",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json",
            "disabled": false,
            "description": null
          },
          {
            "key": "X-TOTUM-KEY",
            "value": "xxxxxxxxxxxxxx",
            "disabled": false,
            "description": null
          }
        ],
        "body": {
          "mode": "raw",
          "disabled": false,
          "raw": "{\"to\":\"5215513447932\",\"interactive\":{\"type\":\"flow\",\"body\":{\"text\":\"Completa este formulario\"},\"action\":{\"name\":\"flow\",\"parameters\":{\"flow_message_version\":\"3\",\"flow_token\":\"TOKEN_UNICO_DEL_FLOW\",\"flow_id\":\"123456789012345\",\"flow_cta\":\"Continuar\",\"flow_action\":\"navigate\",\"flow_action_payload\":{\"screen\":\"INICIO\",\"data\":{\"nombre\":\"Juan\"}}}}}}"
        },
        "auth": null
      },
      "protocolProfileBehavior": {
        "followRedirects": false,
        "followOriginalHttpMethod": false,
        "followAuthorizationHeader": false
      },
      "response": []
    },
    {
      "name": "Obtener Archivo  (imagen, documento, video, etc )",
      "request": {
        "method": "GET",
        "url": {
          "raw": "https://totum-connect.com/api/media/2018305728892380",
          "query": null,
          "protocol": "https",
          "host": [
            "totum-connect",
            "com"
          ],
          "port": null,
          "path": [
            "api",
            "media",
            "2018305728892380"
          ]
        },
        "description": "",
        "header": [
          {
            "key": "X-TOTUM-KEY",
            "value": "xxxxxxxxxxxxxx",
            "disabled": false,
            "description": null
          }
        ],
        "body": null,
        "auth": null
      },
      "protocolProfileBehavior": {
        "followRedirects": false,
        "followOriginalHttpMethod": false,
        "followAuthorizationHeader": false
      },
      "response": []
    }
  ]
}