{"info":{"_postman_id":"393668da-dafe-4154-a5da-913213151558","name":"Karbot API - How to Use 👨‍🏫","description":"<html><head></head><body><p><strong>Karbot API</strong> is a REST interface that provides access to key services for the Karbot platform. Its main functionality focuses on sending messages through WhatsApp.</p>\n<p>Here is a more technical overview of how to use our services, including Authentication, Fetch Line, Fetch Templates, Send Template Message, and Send Session Message.</p>\n<h2 id=\"webhookcallback-url\"><strong>Webhook/Callback URL</strong></h2>\n<p>Webhooks handle incoming messages from users responding on WhatsApp, serving as a critical channel for delivering timely notifications and managing errors.</p>\n<p>When a customer sends a message or responds to templates on WhatsApp, Karbot immediately generates a notification through an HTTP POST request to the webhook previously configured for the corresponding line.</p>\n<p>To enable automatic reception of customer responses, it is necessary to configure the webhook in the Karbot platform from the business line details section. It is recommended to contact an administrator to complete this configuration.</p>\n<p><strong>Note:</strong> The configured webhook must return an HTTP_SUCCESS code (code: 2xx) along with an empty response. If this is not done within 10 seconds, the notification will be considered a failure, and the webhook cannot be set up.</p>\n<p><strong>Example of a received text message:</strong></p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n    \"app\": \"LineName\",\n    \"timestamp\": 1702489054213,\n    \"version\": 2,\n    \"type\": \"message\",\n    \"payload\": {\n        \"id\": \"ABGHUhMkEBMXDwIKOiGSN8IQ58Kc4w\",\n        \"source\": \"5211234567891\",\n        \"type\": \"text\",\n        \"payload\": {\n            \"text\": \"hi\"\n        },\n        \"sender\": {\n            \"phone\": \"5211234567891\",\n            \"name\": \"client name\",\n            \"country_code\": \"52\",\n            \"dial_code\": \"11234567891\"\n        }\n    }\n}\n\n</code></pre>\n<p><strong>Example Request when a quick reply is pressed:</strong></p>\n<pre class=\"click-to-expand-wrapper is-snippet-wrapper\"><code class=\"language-json\">{\n    \"app\": \"LineName\",\n    \"timestamp\": 1702533767736,\n    \"version\": 2,\n    \"type\": \"message\",\n    \"payload\": {\n        \"id\": \"ABGHUhMzgIVDbwIKOoGepkzTRjELjA\",\n        \"source\": \"5211234567891\",\n        \"type\": \"quick_reply\",\n        \"payload\": {\n            \"text\": \"Contact\",\n            \"type\": \"button\"\n        },\n        \"sender\": {\n            \"phone\": \"5211234567891\",\n            \"name\": \"client name\",\n            \"country_code\": \"52\",\n            \"dial_code\": \"11234567891\"\n        },\n        \"context\": {\n            \"id\": \"bd6fd4da-a2e4-4098-87ca-88f9c81f2dc5\",\n            \"gsId\": \"3dfd76c4-2ac5-4435-99db-be9a412d0e5a\",\n            \"forwarded\": false,\n            \"frequently_forwarded\": false\n        }\n    }\n}\n\n</code></pre>\n</body></html>","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"37004296","collectionId":"393668da-dafe-4154-a5da-913213151558","publishedId":"2sAYQWJDBf","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"7348FF"},"publishDate":"2025-01-10T20:04:30.000Z"},"item":[{"name":"Users","item":[{"name":"Auth","id":"a4beead8-b508-4fcc-bf77-e558cb7c8ff4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"email\": \"user@karlo.io\",\n    \"password\": \"pass\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.karbot.mx/v1/users/auth/","description":"<p><strong>Description:</strong></p>\n<p>This endpoint allows users to authenticate using a valid username and password. It returns an access token for subsequent requests.</p>\n<p>Users must authenticate with a web service role to use the API.</p>\n<p>The generated token has an expiration period of <strong>10 days</strong> from the time of creation. After 10 days, the token will no longer be valid, and the user will need to log in again to obtain a new token.</p>\n<p>It is recommended to renew the token by logging in again every <strong>9 days</strong> to ensure uninterrupted access to protected resources.</p>\n<p><strong>Request Body:</strong></p>\n<ul>\n<li><p><strong>email</strong>: This is the email address of the user with the web service role.</p>\n</li>\n<li><p><strong>password</strong>: Password of the user with the web service role.</p>\n</li>\n</ul>\n","urlObject":{"protocol":"https","path":["v1","users","auth",""],"host":["api","karbot","mx"],"query":[],"variable":[]}},"response":[{"id":"e3926411-a0d1-471e-8d53-69018a80385f","name":"Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"email\": \"user@karlo.io\",\n    \"password\": \"pass\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.karbot.mx/v1/users/auth/"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n    \"message\": \"OK\",\n    \"statusCode\": 200,\n    \"description\": \"Inicio de sesión exitoso\",\n    \"outPut\": {\n        \"userId\": 1,\n        \"name\": \"user\",\n        \"email\": \"user@karlo.io\",\n        \"lineId\": 1,\n        \"token\": \"eyJhbGc...\",\n        \"tokenExpirationDate\": \"2023-12-24T17:29:11-06:00\"\n    }\n}"},{"id":"8a6e79da-1133-432f-8eb0-35a2e19b39bf","name":"Failed","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"email\": \"user@karlo.io\",\n    \"password\": \"incorrectPass\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.karbot.mx/v1/users/auth/"},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n    \"message\": \"Unauthorized\",\n    \"statusCode\": 401,\n    \"description\": \"Credenciales incorrectas\",\n    \"outPut\": null\n}"}],"_postman_id":"a4beead8-b508-4fcc-bf77-e558cb7c8ff4"}],"id":"4c8d294d-215f-4387-9e3a-61ad6c6bb979","_postman_id":"4c8d294d-215f-4387-9e3a-61ad6c6bb979","description":""},{"name":"Lines","item":[{"name":"Line","id":"30b4231f-57a7-4945-bd76-e1ef9c3841bc","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"<token>"}]},"isInherited":false},"method":"GET","header":[],"url":"https://api.karbot.mx/v1/lines/","description":"<p><strong>Description:</strong></p>\n<p>This endpoint allows you to retrieve information about the configured line for using the API. The returned information depends on the authorization token provided.</p>\n<p><strong>Request Parameters:</strong></p>\n<p>No additional parameters are required beyond the authorization token provided in the headers.</p>\n","urlObject":{"protocol":"https","path":["v1","lines",""],"host":["api","karbot","mx"],"query":[],"variable":[]}},"response":[{"id":"adc657c2-8d45-4b58-a7ee-ae9b64a1bc18","name":"Success","originalRequest":{"method":"GET","header":[],"url":"https://api.karbot.mx/v1/lines/"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n    \"message\": \"OK\",\n    \"statusCode\": 200,\n    \"description\": \"La información de la linea se obtuvo con éxito.\",\n    \"outPut\": {\n        \"businessId\": 10,\n        \"lineId\": 26,\n        \"appName\": \"PruebasKarbot\",\n        \"phoneNumber\": \"13341864797\",\n        \"useForLine\": \"Omnichannel-Outbound\",\n        \"additionalBalance\": 0,\n        \"bidirectional\": true,\n        \"currentBalance\": 689,\n        \"webhook\": \"\",\n        \"webhookIsActive\": true\n    }\n}"},{"id":"1a66830f-d54d-4455-b76d-d1c6bbb029d4","name":"Failed","originalRequest":{"method":"GET","header":[],"url":"https://api.karbot.mx/v1/lines/"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n    \"message\": \"Bad Request\",\n    \"statusCode\": 400,\n    \"description\": \"No se encontró línea configurada. Por favor, asegúrate de configurar una línea y volver a iniciar sesión.\",\n    \"outPut\": null\n}"},{"id":"eff3a1d5-85f1-443a-a450-3ca26183a95e","name":"Unauthorized","originalRequest":{"method":"GET","header":[],"url":"https://api.karbot.mx/v1/lines/"},"status":"Unauthorized","code":401,"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"Unauthorized"}],"_postman_id":"30b4231f-57a7-4945-bd76-e1ef9c3841bc"}],"id":"8163db83-eb8f-407f-a193-45657a80ab43","_postman_id":"8163db83-eb8f-407f-a193-45657a80ab43","description":""},{"name":"Templates","item":[{"name":"Templates","id":"5aa2388c-7bfb-4f24-8014-7ed58edbd7cc","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"<token>"}]},"isInherited":false},"method":"GET","header":[],"url":"https://api.karbot.mx/v1/templates/","description":"<p><strong>Description:</strong></p>\n<p>This endpoint allows you to retrieve information about the templates configured on a specific line. The returned information depends on the authorization token provided.</p>\n<p><strong>Request Parameters:</strong></p>\n<p>No additional parameters are required beyond the authorization token provided in the headers.</p>\n","urlObject":{"protocol":"https","path":["v1","templates",""],"host":["api","karbot","mx"],"query":[],"variable":[]}},"response":[{"id":"1cf3a10f-f5d0-4860-85d7-ab5a8dbb34f1","name":"Success","originalRequest":{"method":"GET","header":[],"url":"https://api.karbot.mx/v1/templates/"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n    \"message\": \"OK\",\n    \"statusCode\": 200,\n    \"description\": \"La información de las plantillas se obtuvo con éxito.\",\n    \"outPut\": [\n        {\n            \"id\": 130,\n            \"templateId\": \"f683de2e-1824-4f78-8776-6ff0496b7bd1\",\n            \"templateName\": \"Saldo 1816\",\n            \"status\": \"APPROVED\",\n            \"templateCategory\": \"UTILITY\",\n            \"numberVariables\": 0,\n            \"example\": \"hola, favor de pagar saldop pendiente\",\n            \"buttons\": \"{}\",\n            \"createdAt\": \"2023-07-11T00:15:58.794Z\"\n        },\n        {\n            \"id\": 129,\n            \"templateId\": \"66832765-5b5b-4c9f-9d51-a28947a4800e\",\n            \"templateName\": \"saludo a cliente 2\",\n            \"status\": \"APPROVED\",\n            \"templateCategory\": \"MARKETING\",\n            \"numberVariables\": 0,\n            \"example\": \"Hola Cliente amigo\",\n            \"buttons\": \"{}\",\n            \"createdAt\": \"2023-06-27T17:37:16.842Z\"\n        },\n    ]\n}"},{"id":"15635ea3-3c4c-4a16-b181-3e316623df6c","name":"Failed","originalRequest":{"method":"GET","header":[],"url":"https://api.karbot.mx/v1/templates/"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n    \"message\": \"Bad Request\",\n    \"statusCode\": 400,\n    \"description\": \"No se encontraron plantillas para línea configurada.\",\n    \"outPut\": null\n}"},{"id":"7c95f509-ad61-4022-9e9a-974b19a462ff","name":"Unauthorized","originalRequest":{"method":"GET","header":[],"url":"https://api.karbot.mx/v1/templates/"},"status":"Unauthorized","code":401,"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"Unauthorized"}],"_postman_id":"5aa2388c-7bfb-4f24-8014-7ed58edbd7cc"},{"name":"Template","id":"965588ce-ee1b-44e1-bd21-29a95a6e0889","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"<token>"}]},"isInherited":false},"method":"GET","header":[],"url":"https://api.karbot.mx/v1/templates/:templateId/?firstDate=2025-05-20&endDate=2025-05-30","description":"<p><strong>Description:</strong></p>\n<p>This endpoint Retrieves sending statistics for a specific message template. The returned information depends on the authorization token provided.</p>\n","urlObject":{"protocol":"https","path":["v1","templates",":templateId",""],"host":["api","karbot","mx"],"query":[{"description":{"content":"<p>Optional. The start date from which to retrieve statistics. Must be in ISO 8601 format (YYYY-MM-DD). If not provided, data from the last 14 days will be used by default.</p>\n","type":"text/plain"},"key":"firstDate","value":"2025-05-20"},{"description":{"content":"<p>Optional. The end date up to which to retrieve statistics. Must be in ISO 8601 format (YYYY-MM-DD). If not provided, today’s date will be used by default.</p>\n","type":"text/plain"},"key":"endDate","value":"2025-05-30"}],"variable":[{"description":{"content":"<p>Required. This field indicates the ID of the template to retrieve statistics for.</p>\n","type":"text/plain"},"type":"any","value":"d62eca79-44e1-417c-a63d-a37e23b4560b","key":"templateId"}]}},"response":[{"id":"44606c7f-8e44-4052-9434-51deb1c871e0","name":"Success","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.karbot.mx/v1/templates/d62eca79-44e1-417c-a63d-a37e23b4560b/?firstDate=2025-05-20&endDate=2025-05-30","protocol":"https","host":["api","karbot","mx"],"path":["v1","templates","d62eca79-44e1-417c-a63d-a37e23b4560b",""],"query":[{"key":"firstDate","value":"2025-05-20"},{"key":"endDate","value":"2025-05-30"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n    \"message\": \"OK\",\n    \"statusCode\": 200,\n    \"description\": \"La información de la plantilla se obtuvo con éxito.\",\n    \"outPut\": {\n        \"id\": 200,\n        \"templateId\": \"d62eca79-44e1-417c-a63d-a37e23b4560b\",\n        \"templateName\": \"paquetes karbot 1348\",\n        \"templateCategory\": \"MARKETING\",\n        \"templateType\": \"DOCUMENT\",\n        \"example\": \"Hola estos son los paquetes\",\n        \"createdAt\": \"2023-07-11T00:15:58.794Z\",\n        \"templateStats\": [\n            {\n                \"templateStatus\": \"total\",\n                \"countStatus\": 13\n            },\n            {\n                \"templateStatus\": \"scope\",\n                \"countStatus\": 10\n            },\n            {\n                \"templateStatus\": \"interaction\",\n                \"countStatus\": 8\n            },\n            {\n                \"templateStatus\": \"invalid numbers\",\n                \"countStatus\": 3\n            },\n            {\n                \"templateStatus\": \"rate\",\n                \"countStatus\": \"80.00\"\n            }\n        ]\n    }\n}"},{"id":"627817c4-c6c0-466d-8e10-a9d2f1962622","name":"Failed","originalRequest":{"method":"GET","header":[],"url":"https://api.karbot.mx/v1/templates/d62eca79-44e1-417c-a63d-1234"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n    \"message\": \"Bad Request\",\n    \"statusCode\": 400,\n    \"description\": \"No se encontraron plantillas para línea configurada.\",\n    \"outPut\": null\n}"},{"id":"303e6356-8da0-44c3-9d3f-a8f2b5243ef7","name":"Unauthorized","originalRequest":{"method":"GET","header":[],"url":"https://api.karbot.mx/v1/templates/d62eca79-44e1-417c-a63d-1234"},"status":"Unauthorized","code":401,"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"Unauthorized"}],"_postman_id":"965588ce-ee1b-44e1-bd21-29a95a6e0889"}],"id":"d9ed37a5-0c10-45c2-8271-42e4fb0fefac","_postman_id":"d9ed37a5-0c10-45c2-8271-42e4fb0fefac","description":""},{"name":"Messages","item":[{"name":"Send Template Message","id":"a3baa9ae-e242-4902-87a8-99d7a38503b4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"<token>"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"countryCode\": \"52\",\n    \"to\": \"1234567891\",\n    \"templateName\": \"paquetes karbot 1348\",\n    \"fileUrl\": \"https://karbot-files.s3.us-east-2.amazonaws.com/development/chats-files/16800352585507131785066815313.pdf\",\n    \"variables\": [\n        \"1623\"\n    ]\n}","options":{"raw":{"language":"json"}}},"url":"https://api.karbot.mx/v1/messages/send-template","description":"<p><strong>Description:</strong></p>\n<p>This endpoint allows users to send messages based on a predefined template. When a request is made via a template message, an outbound lead is created based on the selected template (Advisor Assignment).</p>\n<p><strong>Request Body:</strong></p>\n<ul>\n<li><p><strong>countryCode (optional)</strong>: This field represents the country code to which the message will be sent. This field is optional. If not provided, the default country code of Mexico will be used.</p>\n</li>\n<li><p><strong>to</strong>: Specifies the phone number of the recipient to whom the message will be sent.</p>\n</li>\n<li><p><strong>templateName / templateId:</strong> You can provide either the templateName or the templateId to identify the template to be used. It is not required to send both; the request is valid if only one of the two is provided.</p>\n</li>\n<li><p><strong>variables</strong>: This field contains a list of variables that will be used in the message template. These variables are placeholders within the template that will be filled with specific information before sending the message.</p>\n</li>\n<li><p><strong>fileUrl (optional)</strong>: The URL of the image or document file to be included in the message. This parameter is required when the selected template includes an image or document component. The file must be publicly accessible via the provided URL.</p>\n</li>\n</ul>\n","urlObject":{"protocol":"https","path":["v1","messages","send-template"],"host":["api","karbot","mx"],"query":[],"variable":[]}},"response":[{"id":"434e2bcb-c2d7-4d63-9245-9aaa7c9d8bc0","name":"Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"countryCode\": \"52\",\n    \"to\": \"1234567891\",\n    \"templateName\": \"paquetes karbot 1348\",\n    \"fileUrl\": \"https://karbot-files.s3.us-east-2.amazonaws.com/development/chats-files/16800352585507131785066815313.pdf\",\n    \"variables\": [\n        \"1623\"\n    ]\n}","options":{"raw":{"language":"json"}}},"url":"https://api.karbot.mx/v1/messages/send-template"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n    \"message\": \"OK\",\n    \"statusCode\": 200,\n    \"description\": \"Se envió mensaje de plantilla con éxito.\",\n    \"outPut\": {\n        \"id\": 6037,\n        \"sentId\": 2525,\n        \"status\": \"ENVIADO\",\n        \"countryCode\": \"52\",\n        \"phoneNumber\": \"3241013170\",\n        \"gsId\": \"10a78650-dc01-43eb-aacd-f9ccb11b5c3a\",\n        \"createdAt\": \"2025-05-27T19:13:02.664Z\"\n    }\n}"},{"id":"1de37626-1736-43e0-ab57-b61f2a739482","name":"Failed","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"countryCode\": \"52\",\n    \"to\": \"1234567891\",\n    \"templateId\": \"123456\",\n    \"variables\": [\n        \"1623\"\n    ]\n}","options":{"raw":{"language":"json"}}},"url":"https://api.karbot.mx/v1/messages/send-template"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n    \"message\": \"Bad Request\",\n    \"statusCode\": 400,\n    \"description\": \"La plantilla enviada no fue encontrada.\",\n    \"outPut\": \"Nonbre de plantilla: una plantilla\"\n}"},{"id":"2d855e0d-53ca-42b3-9a59-61482a4a1aa8","name":"Unauthorized","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"countryCode\": \"52\",\n    \"to\": \"1234567891\",\n    \"templateId\": \"1fc4cafe-bd57-4539-9b9a-dcb845ff9260\",\n    \"variables\": [\n        \"1623\"\n    ]\n}","options":{"raw":{"language":"json"}}},"url":"https://api.karbot.mx/v1/messages/send-template"},"status":"Unauthorized","code":401,"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"Unauthorized"}],"_postman_id":"a3baa9ae-e242-4902-87a8-99d7a38503b4"},{"name":"Send Template Messages","id":"6515801c-2218-4c6d-bc2d-48c575e14ce0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"<token>"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"templateName\": \"Diferentes botones\",\n    \"messages\": [\n        {\n            \"countryCode\": \"52\",\n            \"to\": \"1234561654\",\n            \"variables\": [\n                \"123\"\n            ]\n        },\n        {\n            \"countryCode\": \"1\",\n            \"to\": \"1234561655\",\n            \"variables\": [\n                \"1234\"\n            ]\n        }\n    ]\n}","options":{"raw":{"language":"json"}}},"url":"https://api.karbot.mx/v1/messages/send-template-messages","description":"<p><strong>Description:</strong></p>\n<p>This endpoint allows users to sends multiple messages using a specified message template. When a request is made through this endpoint, each message triggers the creation of an outbound lead based on the selected template (Advisor Assignment). This allows for mass communication while automatically associating each recipient with a lead and advisor.</p>\n<p><strong>Request Body:</strong></p>\n<ul>\n<li><p><strong>templateName / templateId:</strong> You can provide either the templateName or the templateId to identify the template to be used. It is not required to send both; the request is valid if only one of the two is provided.</p>\n</li>\n<li><p><strong>messages</strong>: An array of objects, where each object represents an individual message to be sent using the selected template. Each object must include the necessary data required to send a message, such as the recipient’s phone number and any dynamic template parameters.</p>\n</li>\n<li><p><strong>countryCode (optional)</strong>: This field represents the country code to which the message will be sent. This field is optional. If not provided, the default country code of Mexico will be used.</p>\n</li>\n<li><p><strong>to</strong>: Specifies the phone number of the recipient to whom the message will be sent.</p>\n</li>\n<li><p><strong>variables</strong>: This field contains a list of variables that will be used in the message template. These variables are placeholders within the template that will be filled with specific information before sending the message.</p>\n</li>\n<li><p><strong>fileUrl</strong>: The URL of the image or document file to be included in the message. This parameter is required when the selected template includes an image or document component. The file must be publicly accessible via the provided URL.</p>\n</li>\n</ul>\n","urlObject":{"protocol":"https","path":["v1","messages","send-template-messages"],"host":["api","karbot","mx"],"query":[],"variable":[]}},"response":[{"id":"277a5054-4cb9-47b4-afa6-7c99be6d9653","name":"Success (templateName)","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"templateName\": \"Diferentes botones\",\n    \"messages\": [\n        {\n            \"countryCode\": \"52\",\n            \"to\": \"1234561654\",\n            \"variables\": [\n                \"123\"\n            ]\n        },\n        {\n            \"countryCode\": \"1\",\n            \"to\": \"1234561655\",\n            \"variables\": [\n                \"1234\"\n            ]\n        }\n    ]\n}","options":{"raw":{"language":"json"}}},"url":"https://api.karbot.mx/v1/messages/send-template-messages"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n    \"message\": \"OK\",\n    \"statusCode\": 200,\n    \"description\": \"Se enviaron mensajes de plantilla con éxito.\",\n    \"outPut\": [\n        {\n            \"id\": 6035,\n            \"sentId\": 2524,\n            \"status\": \"ENVIADO\",\n            \"countryCode\": \"52\",\n            \"phoneNumber\": \"1234561654\",\n            \"gsId\": \"b6bd5920-a4a5-45bf-9ed0-6b54ed91a318\",\n            \"createdAt\": \"2025-05-27T18:57:53.465Z\"\n        },\n        {\n            \"id\": 6036,\n            \"sentId\": 2524,\n            \"status\": \"ENVIADO\",\n            \"countryCode\": \"1\",\n            \"phoneNumber\": \"1234561655\",\n            \"gsId\": \"deb8befb-3f73-4764-953d-6bbe3013e669\",\n            \"createdAt\": \"2025-05-27T18:57:53.465Z\"\n        }\n    ]\n}"},{"id":"f5e4ba49-d4ec-4d6b-9476-0a8b2991e41c","name":"Success (templateId)","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"templateId\": \"1358b06d-c380-4fad-bdfb-d9bc9f042349\",\n    \"messages\": [\n        {\n            \"countryCode\": \"52\",\n            \"to\": \"1234561654\",\n            \"variables\": [\n                \"123\"\n            ]\n        },\n        {\n            \"countryCode\": \"1\",\n            \"to\": \"1234561655\",\n            \"variables\": [\n                \"1234\"\n            ]\n        }\n    ]\n}","options":{"raw":{"language":"json"}}},"url":"https://api.karbot.mx/v1/messages/send-template-messages"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n    \"message\": \"OK\",\n    \"statusCode\": 200,\n    \"description\": \"Se enviaron mensajes de plantilla con éxito.\",\n    \"outPut\": [\n        {\n            \"id\": 6035,\n            \"sentId\": 2524,\n            \"status\": \"ENVIADO\",\n            \"countryCode\": \"52\",\n            \"phoneNumber\": \"1234561654\",\n            \"gsId\": \"b6bd5920-a4a5-45bf-9ed0-6b54ed91a318\",\n            \"createdAt\": \"2025-05-27T18:57:53.465Z\"\n        },\n        {\n            \"id\": 6036,\n            \"sentId\": 2524,\n            \"status\": \"ENVIADO\",\n            \"countryCode\": \"1\",\n            \"phoneNumber\": \"1234561655\",\n            \"gsId\": \"deb8befb-3f73-4764-953d-6bbe3013e669\",\n            \"createdAt\": \"2025-05-27T18:57:53.465Z\"\n        }\n    ]\n}"},{"id":"bfcfdfaa-909a-4c4e-ae70-f198ce3d2880","name":"Success (fileUrl)","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"templateName\": \"paquetes karbot 1348\",\n    \"messages\": [\n        {\n            \"countryCode\": \"52\",\n            \"to\": \"1234561224\",\n            \"fileUrl\": \"https://karbot-files.s3.us-east-2.amazonaws.com/production/pdfKarbot2021/KB+-+Paquetes+de+mensajes.pdf\",\n            \"variables\": [\n                \"1224\"\n            ]\n        },\n        {\n            \"countryCode\": \"1\",\n            \"to\": \"1234561225\",\n            \"fileUrl\": \"https://karbot-files.s3.us-east-2.amazonaws.com/production/pdfKarbot2021/KB+-+Paquetes+de+mensajes.pdf\",\n            \"variables\": [\n                \"1225\"\n            ]\n        }\n    ]\n}","options":{"raw":{"language":"json"}}},"url":"https://api.karbot.mx/v1/messages/send-template-messages"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n    \"message\": \"OK\",\n    \"statusCode\": 200,\n    \"description\": \"Se enviaron mensajes de plantilla con éxito.\",\n    \"outPut\": [\n        {\n            \"id\": 6035,\n            \"sentId\": 2524,\n            \"status\": \"ENVIADO\",\n            \"countryCode\": \"52\",\n            \"phoneNumber\": \"1234561224\",\n            \"gsId\": \"b6bd5920-a4a5-45bf-9ed0-6b54ed91a318\",\n            \"createdAt\": \"2025-05-27T18:57:53.465Z\"\n        },\n        {\n            \"id\": 6036,\n            \"sentId\": 2524,\n            \"status\": \"ENVIADO\",\n            \"countryCode\": \"1\",\n            \"phoneNumber\": \"1234561225\",\n            \"gsId\": \"deb8befb-3f73-4764-953d-6bbe3013e669\",\n            \"createdAt\": \"2025-05-27T18:57:53.465Z\"\n        }\n    ]\n}"},{"id":"2bd188e7-ad84-4e28-865c-1e404448ac84","name":"Failed","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"templateName\": \"paquetes kar\",\n    \"messages\": [\n        {\n            \"countryCode\": \"52\",\n            \"to\": \"1234561224\",\n            \"fileUrl\": \"https://karbot-files.s3.us-east-2.amazonaws.com/production/pdfKarbot2021/KB+-+Paquetes+de+mensajes.pdf\",\n            \"variables\": [\n                \"1224\"\n            ]\n        },\n        {\n            \"countryCode\": \"1\",\n            \"to\": \"1234561225\",\n            \"fileUrl\": \"https://karbot-files.s3.us-east-2.amazonaws.com/production/pdfKarbot2021/KB+-+Paquetes+de+mensajes.pdf\",\n            \"variables\": [\n                \"1225\"\n            ]\n        }\n    ]\n}","options":{"raw":{"language":"json"}}},"url":"https://api.karbot.mx/v1/messages/send-template-messages"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n    \"message\": \"Bad Request\",\n    \"statusCode\": 400,\n    \"description\": \"La plantilla enviada no fue encontrada.\",\n    \"outPut\": \"Nonbre de plantilla: una plantilla\"\n}"},{"id":"de819e1c-7156-4119-9e4a-40eaff923d75","name":"Unauthorized","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"templateName\": \"paquetes kar\",\n    \"messages\": [\n        {\n            \"countryCode\": \"52\",\n            \"to\": \"1234561224\",\n            \"fileUrl\": \"https://karbot-files.s3.us-east-2.amazonaws.com/production/pdfKarbot2021/KB+-+Paquetes+de+mensajes.pdf\",\n            \"variables\": [\n                \"1224\"\n            ]\n        },\n        {\n            \"countryCode\": \"1\",\n            \"to\": \"1234561225\",\n            \"fileUrl\": \"https://karbot-files.s3.us-east-2.amazonaws.com/production/pdfKarbot2021/KB+-+Paquetes+de+mensajes.pdf\",\n            \"variables\": [\n                \"1225\"\n            ]\n        }\n    ]\n}","options":{"raw":{"language":"json"}}},"url":"https://api.karbot.mx/v1/messages/send-template-messages"},"status":"Unauthorized","code":401,"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"Unauthorized"}],"_postman_id":"6515801c-2218-4c6d-bc2d-48c575e14ce0"},{"name":"Send Session Message","id":"1e466aff-c491-4361-8b6a-df1e18f43bb4","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"<token>"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"countryCode\": \"52\",\n    \"to\": \"1234567891\",\n    \"type\": \"text\",\n    \"message\": \"hi\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.karbot.mx/v1/messages/send-session","description":"<p><strong>Description:</strong></p>\n<p>This endpoint allows users to send a session message. Session messages can only be sent within 24 hours after the last message sent by the user. If you try to send a message outside of this 24-hour window, you will receive an error event in your webhook.</p>\n<p><strong>Request Body:</strong></p>\n<ul>\n<li><p><strong>countryCode (optional)</strong>: The country code of the recipient’s phone number. This field is optional, and if not provided, the default country code for Mexico will be used.</p>\n</li>\n<li><p><strong>to</strong>: The phone number of the recipient to whom the message will be sent.</p>\n</li>\n<li><p><strong>type</strong>: This field indicates the type of session message.</p>\n</li>\n<li><p><strong>message</strong>: The content of the message to be sent.</p>\n</li>\n</ul>\n","urlObject":{"protocol":"https","path":["v1","messages","send-session"],"host":["api","karbot","mx"],"query":[],"variable":[]}},"response":[{"id":"da75e460-6a13-444c-8c72-a777e78f0839","name":"Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"countryCode\": \"52\",\n    \"to\": \"1234567891\",\n    \"type\": \"text\",\n    \"message\": \"hi\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.karbot.mx/v1/messages/send-session"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n    \"message\": \"OK\",\n    \"statusCode\": 200,\n    \"description\": \"Se envió mensaje de sesión con éxito.\",\n    \"outPut\": {\n        \"status\": \"submitted\",\n        \"messageId\": \"fb593781-5367-441a-bd44-be0b8b166386\"\n    }\n}"},{"id":"5a513bf6-9956-43c4-8da2-f86c1ae56c1c","name":"Failed","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"countryCode\": \"52\",\n    \"to\": \"1234567891\",\n    \"type\": \"text\",\n    \"message\": \"\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.karbot.mx/v1/messages/send-session"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n    \"message\": \"Bad Request\",\n    \"statusCode\": 400,\n    \"description\": \"El texto de mensaje es obligatorio.\",\n    \"outPut\": \"Dato faltante: message.\"\n}"},{"id":"26408f42-40c2-4836-b1a2-600104ca4512","name":"Unauthorized","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"countryCode\": \"52\",\n    \"to\": \"1234567891\",\n    \"type\": \"text\",\n    \"message\": \"hi\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.karbot.mx/v1/messages/send-session"},"status":"Unauthorized","code":401,"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"Unauthorized"}],"_postman_id":"1e466aff-c491-4361-8b6a-df1e18f43bb4"}],"id":"3ae482ce-977b-43bf-afba-7302143442c0","_postman_id":"3ae482ce-977b-43bf-afba-7302143442c0","description":""},{"name":"Leads","item":[{"name":"Create Lead Inbound","id":"5ae0cb72-7fe4-4720-9a6e-0fea47b3bd90","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"<token>"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"canal\": \"SITIO WEB\",\n    \"origin\": \"MERCADO LIBRE\",\n    \"category\": \"ventas seminuevos\",\n    \"phoneNumber\": \"202501171819\",\n    \"name\": \"Alejandro 1819\",\n    \"email\": \"correo@karlo.io\",\n    \"campaign\": \"promoción 1819\",\n    \"referenceId\": \"1806\",\n    \"generalData\": {\n        \"distribuidor\": \"un distribuidor\",\n        \"marca\": \"marca 1819\",\n        \"modelo\": \"modelo 1819\",\n        \"año\": \"2025\",\n        \"mensaje\": \"prueba 1819\"\n    }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.karbot.mx/v1/leads/inbound","description":"<p><strong>Description:</strong></p>\n<p>This endpoint allows the creation of inbound leads and automatically assigns the lead to an available advisor based on the specified category. The system ensures that the lead is categorized correctly and routed to the appropriate advisor for personalized follow-up. It supports various lead sources such as websites, social media platforms, or other digital channels.</p>\n<p><strong>Request Body:</strong></p>\n<ul>\n<li><p><strong>canal</strong>: The source channel where the lead was generated (e.g., website, facebook).</p>\n</li>\n<li><p><strong>origin</strong>: The origin of the lead, such as the platform or campaign (e.g., “Mercado Libre,” “Formulario”).</p>\n</li>\n<li><p><strong>category</strong>: The category to which the lead belongs (e.g., “used car”).</p>\n</li>\n<li><p><strong>phoneNumber</strong>: The phone number of the lead.</p>\n</li>\n<li><p><strong>name (optional)</strong>: The full name of the lead.</p>\n</li>\n<li><p><strong>email (optional)</strong>: The email address of the lead.</p>\n</li>\n<li><p><strong>campaign (optional)</strong>: The name of the campaign associated with the lead.</p>\n</li>\n<li><p><strong>referenceId (optional)</strong>: A unique identifier for the lead.</p>\n</li>\n<li><p><strong>generalData (optional)</strong>: A nested object containing additional details about the lead, such as distributor, brand, model, year, and message.</p>\n</li>\n</ul>\n","urlObject":{"protocol":"https","path":["v1","leads","inbound"],"host":["api","karbot","mx"],"query":[],"variable":[]}},"response":[{"id":"5e2eae43-3a7b-442d-a5fe-1f5c498f4af6","name":"Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"canal\": \"SITIO WEB\",\n    \"origin\": \"MERCADO LIBRE\",\n    \"category\": \"ventas seminuevos\",\n    \"phoneNumber\": \"202506061203\",\n    \"name\": \"Alejandro 1203\",\n    \"email\": \"correo@karlo.io\",\n    \"campaign\": \"promoción 1203\",\n    \"referenceId\": \"1203\",\n    \"generalData\": {\n        \"distribuidor\": \"un distribuidor\",\n        \"marca\": \"marca test\",\n        \"modelo\": \"modelo test\",\n        \"año\": \"2025\",\n        \"mensaje\": \"prueba test\"\n    }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.karbot.mx/v1/messages/send-session"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n    \"message\": \"OK\",\n    \"statusCode\": 200,\n    \"description\": \"Se creó lead inbound con éxito.\",\n    \"outPut\": {\n        \"id\": 2233,\n        \"referenceId\": \"1203\",\n        \"chatId\": \"gUq872UTxeqeBld0dbdP\",\n        \"name\": \"Alejandro 1203\",\n        \"countryCode\": \"20\",\n        \"phoneNumber\": \"202506061203\",\n        \"email\": \"correo@karlo.io\",\n        \"interest\": null,\n        \"status\": \"ASESOR ASIGNADO\",\n        \"canal\": \"SITIO WEB\",\n        \"origin\": \"MERCADO LIBRE\",\n        \"campaign\": \"promoción 1203\",\n        \"createdAt\": \"2025-06-06T18:05:15.171Z\"\n    }\n}"},{"id":"9d836762-2fe6-4817-b05f-737caf590f5e","name":"Failed","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"origin\": \"MERCADO LIBRE\",\n    \"category\": \"ventas seminuevos\",\n    \"phoneNumber\": \"202501171819\",\n    \"name\": \"Alejandro 1819\",\n    \"email\": \"correo@karlo.io\",\n    \"campaign\": \"promoción 1819\",\n    \"referenceId\": \"1806\",\n    \"generalData\": {\n        \"distribuidor\": \"un distribuidor\",\n        \"marca\": \"marca 1819\",\n        \"modelo\": \"modelo 1819\",\n        \"año\": \"2025\",\n        \"mensaje\": \"prueba 1819\"\n    }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.karbot.mx/v1/messages/send-session"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n    \"message\": \"Bad Request\",\n    \"statusCode\": 400,\n    \"description\": \"El canal de lead es obligatorio\",\n    \"outPut\": \"canal\"\n}"},{"id":"4a34650c-8e40-45a8-a0f2-2ea750a0a7c6","name":"Unauthorized","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"canal\": \"SITIO WEB\",\n    \"origin\": \"MERCADO LIBRE\",\n    \"category\": \"ventas seminuevos\",\n    \"phoneNumber\": \"202501171819\",\n    \"name\": \"Alejandro 1819\",\n    \"email\": \"correo@karlo.io\",\n    \"campaign\": \"promoción 1819\",\n    \"referenceId\": \"1806\",\n    \"generalData\": {\n        \"distribuidor\": \"un distribuidor\",\n        \"marca\": \"marca 1819\",\n        \"modelo\": \"modelo 1819\",\n        \"año\": \"2025\",\n        \"mensaje\": \"prueba 1819\"\n    }\n}","options":{"raw":{"language":"json"}}},"url":"https://api.karbot.mx/v1/messages/send-session"},"status":"Unauthorized","code":401,"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"Unauthorized"}],"_postman_id":"5ae0cb72-7fe4-4720-9a6e-0fea47b3bd90"},{"name":"Get Leads Inbound","id":"ed84fcbe-0924-4666-838f-e45b86c9d89f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.karbot.mx/v1/leads/inbound/","description":"<p>Endpoint to retrieve inbound leads filtered by different criteria. Allows querying incoming leads using search parameters such as customer phone number and date range.</p>\n","urlObject":{"protocol":"https","path":["v1","leads","inbound",""],"host":["api","karbot","mx"],"query":[{"disabled":true,"description":{"content":"<p>Optional. Customer’s phone number.</p>\n","type":"text/plain"},"key":"customerPhoneNumber","value":"3312345678"},{"disabled":true,"description":{"content":"<p>Optional. The start date from which to retrieve statistics. Must be in ISO 8601 format (YYYY-MM-DD). If not provided, data from the last 90 days will be used by default.</p>\n","type":"text/plain"},"key":"firstDate","value":"2025-02-25"},{"disabled":true,"description":{"content":"<p>Optional. The end date up to which to retrieve statistics. Must be in ISO 8601 format (YYYY-MM-DD). If not provided, today’s date will be used by default.</p>\n","type":"text/plain"},"key":"endDate","value":"2025-05-25"},{"disabled":true,"description":{"content":"<p>Optional. External reference ID of the lead.</p>\n","type":"text/plain"},"key":"referenceId","value":"123456"},{"disabled":true,"description":{"content":"<p>Optional. Unique internal ID of the lead.</p>\n","type":"text/plain"},"key":"id","value":"123"},{"disabled":true,"description":{"content":"<p>Optional. Customer’s email address.</p>\n","type":"text/plain"},"key":"customerEmail","value":"correo@karlo.io"},{"disabled":true,"description":{"content":"<p>Optional. The source channel where the lead was generated (e.g., website, facebook).</p>\n","type":"text/plain"},"key":"canal","value":"GM"}],"variable":[]}},"response":[{"id":"85ccf0cb-7eba-4825-9127-be14d088b560","name":"Success","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.karbot.mx/v1/leads/inbound/?email=correo@karlo.io","protocol":"https","host":["api","karbot","mx"],"path":["v1","leads","inbound",""],"query":[{"key":"referenceId","value":"1203","description":"Optional. External reference ID of the lead.","disabled":true},{"key":"id","value":"123","description":"Optional. Unique internal ID of the lead.","disabled":true},{"key":"canal","value":"GM","description":"Optional. The source channel where the lead was generated (e.g., website, facebook).","disabled":true},{"key":"phoneNumber","value":"3312345678","description":"Optional. Customer’s phone number.","disabled":true},{"key":"email","value":"correo@karlo.io","description":"Optional. Customer’s email address."}]}},"status":"OK","code":200,"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"{\n    \"message\": \"OK\",\n    \"statusCode\": 200,\n    \"description\": \"Los datos de todos los leads inbound se obtuvieron con éxito.\",\n    \"outPut\": [\n        {\n            \"id\": 2466,\n            \"referenceId\": \"1349\",\n            \"chatId\": null,\n            \"name\": \"Ale 1349\",\n            \"phoneNumber\": \"3241962371\",\n            \"email\": \"correo@karlo.io\",\n            \"interest\": null,\n            \"status\": \"CLIENTE IGNORADO\",\n            \"canal\": \"SITIO WEB\",\n            \"origin\": \"MERCADO LIBRE\",\n            \"campaign\": \"promoción 1349\",\n            \"adviserName\": null,\n            \"createdAt\": \"2025-10-01T19:50:05.192Z\",\n            \"information\": {\n                \"año\": \"2025\",\n                \"marca\": \"marca test\",\n                \"modelo\": \"modelo test\",\n                \"mensaje\": \"prueba test\",\n                \"distribuidor\": \"un distribuidor\"\n            }\n        },\n        {\n            \"id\": 2464,\n            \"referenceId\": \"2025100103\",\n            \"chatId\": null,\n            \"name\": \"Alejandro 2025100103\",\n            \"phoneNumber\": \"3241962371\",\n            \"email\": \"correo@karlo.io\",\n            \"interest\": null,\n            \"status\": \"CONVERSACION INICIADA\",\n            \"canal\": \"SITIO WEB\",\n            \"origin\": \"TIENDA\",\n            \"campaign\": \"promoción 2025100103\",\n            \"adviserName\": null,\n            \"createdAt\": \"2025-10-01T17:32:38.837Z\",\n            \"information\": {\n                \"año\": \"2025\",\n                \"marca\": \"marca test\",\n                \"modelo\": \"modelo test\",\n                \"mensaje\": \"prueba test\",\n                \"distribuidor\": \"un distribuidor\"\n            }\n        },\n        {\n            \"id\": 2463,\n            \"referenceId\": \"2025100102\",\n            \"chatId\": null,\n            \"name\": \"Alejandro 073002\",\n            \"phoneNumber\": \"522025100101\",\n            \"email\": \"correo@karlo.io\",\n            \"interest\": null,\n            \"status\": \"CONVERSACION INICIADA\",\n            \"canal\": \"SITIO WEB\",\n            \"origin\": \"TIENDA\",\n            \"campaign\": \"promoción 2025100102\",\n            \"adviserName\": null,\n            \"createdAt\": \"2025-10-01T17:00:00.742Z\",\n            \"information\": {\n                \"año\": \"2025\",\n                \"marca\": \"marca test\",\n                \"modelo\": \"modelo test\",\n                \"mensaje\": \"prueba test\",\n                \"distribuidor\": \"un distribuidor\"\n            }\n        },\n        {\n            \"id\": 2462,\n            \"referenceId\": \"2025100101\",\n            \"chatId\": null,\n            \"name\": \"Alejandro 073001\",\n            \"phoneNumber\": \"522025100101\",\n            \"email\": \"correo@karlo.io\",\n            \"interest\": null,\n            \"status\": \"CONVERSACION INICIADA\",\n            \"canal\": \"SITIO WEB\",\n            \"origin\": \"TIENDA\",\n            \"campaign\": \"promoción 2025100101\",\n            \"adviserName\": \"Alejandro Asesor\",\n            \"createdAt\": \"2025-10-01T16:59:06.012Z\",\n            \"information\": {\n                \"año\": \"2025\",\n                \"marca\": \"marca test\",\n                \"modelo\": \"modelo test\",\n                \"mensaje\": \"prueba test\",\n                \"distribuidor\": \"un distribuidor\"\n            }\n        }\n    ]\n}"},{"id":"61ed825c-60dd-4cbb-827f-7bbd4a3e2919","name":"Failed","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.karbot.mx/v1/leads/inbound/?firstDate=2025-02-25","protocol":"https","host":["api","karbot","mx"],"path":["v1","leads","inbound",""],"query":[{"key":"referenceId","value":"4321","description":"Optional. External reference ID of the lead.","disabled":true},{"key":"id","value":"123","description":"Optional. Unique internal ID of the lead.","disabled":true},{"key":"canal","value":"GM","description":"Optional. The source channel where the lead was generated (e.g., website, facebook).","disabled":true},{"key":"phoneNumber","value":"3312345678","description":"Optional. Customer’s phone number.","disabled":true},{"key":"email","value":"correo@karlo.io","description":"Optional. Customer’s email address.","disabled":true},{"key":"firstDate","value":"2025-02-25","type":"text"}]}},"status":"Bad Request","code":400,"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"{\n    \"message\": \"Bad Request\",\n    \"statusCode\": 400,\n    \"description\": \"Rango de fechas inválido\",\n    \"outPut\": \"Datos de fecha inválidos.\"\n}"},{"id":"464c85dc-1558-4098-bd79-1589446601e8","name":"Unauthorized","originalRequest":{"method":"GET","header":[],"url":{"raw":"https://api.karbot.mx/v1/leads/inbound/","protocol":"https","host":["api","karbot","mx"],"path":["v1","leads","inbound",""],"query":[{"key":"referenceId","value":"4321","description":"Optional. External reference ID of the lead.","disabled":true},{"key":"id","value":"123","description":"Optional. Unique internal ID of the lead.","disabled":true},{"key":"canal","value":"GM","description":"Optional. The source channel where the lead was generated (e.g., website, facebook).","disabled":true},{"key":"phoneNumber","value":"3312345678","description":"Optional. Customer’s phone number.","disabled":true},{"key":"email","value":"correo@karlo.io","description":"Optional. Customer’s email address.","disabled":true}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":null,"header":null,"cookie":[],"responseTime":null,"body":"Unauthorized"}],"_postman_id":"ed84fcbe-0924-4666-838f-e45b86c9d89f"},{"name":"Assign Lead Inbound By CrmId","id":"2944e2e3-83bc-4a4f-aa9d-59387cd17483","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"<token>"}]},"isInherited":false},"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"crmAdviserId\": \"123456\",\n    \"referenceId\": \"166826\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.karbot.mx/v1/leads/inbound/assign-by-crm-id","description":"<p><strong>Description:</strong></p>\n<p>This endpoint allows the creation of inbound leads and automatically assigns the lead to an available advisor based on the specified category. The system ensures that the lead is categorized correctly and routed to the appropriate advisor for personalized follow-up. It supports various lead sources such as websites, social media platforms, or other digital channels.</p>\n<p><strong>Request Body:</strong></p>\n<ul>\n<li><p><strong>crmAdviserId</strong>: External identifier of the adviser user in the CRM. This field is used to link the external adviser to the corresponding user in Karbot.</p>\n</li>\n<li><p><strong>referenceId</strong>: A unique external identifier for the lead.</p>\n</li>\n</ul>\n","urlObject":{"protocol":"https","path":["v1","leads","inbound","assign-by-crm-id"],"host":["api","karbot","mx"],"query":[],"variable":[]}},"response":[{"id":"855bf69e-2765-4f0e-a4c3-38121111f5d1","name":"Success","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"crmAdviserId\": \"123456\",\n    \"referenceId\": \"166826\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.karbot.mx/v1/leads/inbound/assign-by-crm-id"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[],"responseTime":null,"body":"{\n    \"message\": \"OK\",\n    \"statusCode\": 200,\n    \"description\": \"La conversación se asignó con éxito.\",\n    \"outPut\": \"El lead se asignó al asesor con número 3241962371\"\n}"},{"id":"5fbc9b52-2953-4348-894d-18b701abcaca","name":"Failed","originalRequest":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\n    \"crmAdviserId\": \"1739\",\n    \"referenceId\": \"159906\"\n}","options":{"raw":{"language":"json"}}},"url":"https://api.karbot.mx/v1/leads/inbound/assign-by-crm-id"},"status":"Bad Request","code":400,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json","description":"","type":"text"}],"cookie":[{"expires":"Invalid Date","domain":"","path":""}],"responseTime":null,"body":"{\n    \"message\": \"Bad Request\",\n    \"statusCode\": 400,\n    \"description\": \"No se encontró asesor válido con los datos proporcionados.\",\n    \"outPut\": \"businessId: 10, crmAdviserId: 1739.\"\n}"}],"_postman_id":"2944e2e3-83bc-4a4f-aa9d-59387cd17483"}],"id":"1e1ca72a-5dcc-4ae9-8b3d-2dbd74384770","_postman_id":"1e1ca72a-5dcc-4ae9-8b3d-2dbd74384770","description":""}]}