/devices/{deviceId}/autorepliesActualizar respuestas automáticas
Actualiza la configuración de respuestas automáticas del número de WhatsApp actual.
PATCH https://api.getincloud.ai/v1/devices/{deviceId}/autorepliesActualiza la configuración de respuestas automáticas del número de WhatsApp actual.
Tipos de respuestas automáticas:
- welcome: envía un mensaje cuando un contacto nuevo inicia una conversación con tu número.
- away: envía un mensaje cuando un usuario te escribe fuera del horario laboral de los días de la semana.
- busy: envía un mensaje si tu equipo está ocupado y no puede responder con la fluidez suficiente, según un plazo predefinido, por ejemplo: 5 minutos. Requiere un plan Business o Enterprise.
- follow: envía un mensaje de seguimiento a los chats después de un plazo específico o bajo ciertas condiciones. Requiere un plan Business o Enterprise.
- call: envía un mensaje automático cuando se recibe una llamada entrante, para informar a los usuarios de que quizá no aceptes llamadas de voz. Requiere un plan Business o Enterprise.
Las respuestas automáticas se gestionan fuera de la aplicación de WhatsApp, por lo que funcionan tanto con números de WhatsApp Personal como de WhatsApp Business.
Si usas un número de WhatsApp Business, debes verificar que las respuestas automáticas de la aplicación estén desactivadas; de lo contrario, tu número podría enviar respuestas duplicadas y provocar otros escenarios no deseados.
Importante: la función de respuestas automáticas solo está disponible para números que usan un plan Platform (enviar y recibir mensajes).
De lo contrario, devolverá un estado de respuesta 403 - Forbidden.
Prueba este endpoint en el probador de API en vivo
>¿Necesitas ayuda? Explora todos los tutoriales, más de 100 ejemplos de casos de uso y prueba el probador de API en vivo con ejemplos de código listos para usar en más de 15 lenguajes de programación, incluidos JavaScript/Node.js, PHP, Python, C#, Java, Ruby, Swift, Kotlin, Powershell, cURL y más.
Autenticación
Envía tu API key en el encabezado Token en cada petición.
Cuerpo de la petición
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
welcome | object | No | Configura una respuesta automática como mensaje de bienvenida para los usuarios que te contactan por primera vez, o cuando no te han contactado en un tiempo según el plazo configurado. Por ejemplo: 7 días. Nota: si usas WhatsApp Business, asegúrate de haber desactivado las respuestas automáticas en la aplicación de WhatsApp; de lo contrario, podrías tener conflictos al enviar respuestas automáticas. |
welcome.active | ['boolean', 'null'] | Sí | Activa o desactiva el mensaje de respuesta automática de bienvenida |
welcome.message | ['string', 'null'] | No | Mensaje que se enviará como respuesta automática de bienvenida, hasta 3000 caracteres. minLength: 0 · maxLength: 3000 |
welcome.file | ['string', 'null'] | No | ID opcional de un archivo de imagen (24 caracteres hexadecimales) que se enviará como respuesta automática. El archivo de imagen debe haberse subido previamente al sistema. Solo se pueden enviar imágenes como respuestas automáticas, con un tamaño de archivo de hasta 2 MB. Omítelo para conservar la imagen actual. Para eliminarla, envía null o incluye file en remove. minLength: 24 · maxLength: 24 · pattern: ^[0-9a-fA-F]{24}$ |
welcome.target | string | No | Destino opcional del mensaje de bienvenida: usa all para responder a cualquier chat nuevo, o usa new_contacts para responder solo a los chats nuevos iniciados por números que no están en tu agenda de contactos. enum: ['all', 'new_contacts'] · default: all |
welcome.timeframe | string | No | Plazo opcional para el mensaje de bienvenida: usa 14d para enviar el mensaje de bienvenida en chats que no tuvieron mensajes previos en los últimos 14 días, o usa un plazo distinto según las opciones disponibles. enum: ['24h', '2d', '3d', '7d', '14d', '30d', '60d'] · default: 14d |
welcome.setLabels | array<string> | No | Lista opcional de etiquetas de chat que se añadirán cuando se responda automáticamente a un chat. |
welcome.skipResolved | boolean | No | Indicador opcional para omitir el envío del mensaje de bienvenida a chats que han sido resueltos. Los chats resueltos son chats que han sido cerrados por el usuario o por el sistema. |
welcome.skipAssigned | boolean | No | Indicador opcional para omitir el envío del mensaje de bienvenida a chats que han sido asignados a un agente y no han sido resueltos, eliminados ni bloqueados. Los chats asignados son chats que han sido asignados a un agente por el sistema o manualmente por un agente. |
welcome.skipNumbers | array<string> | No | Lista opcional de números de teléfono que se ignorarán al enviar el mensaje de bienvenida. El número de teléfono debe estar en formato E.164, por ejemplo: +16001234560 |
welcome.remove | array<string> | No | Elimina opcionalmente los valores de los campos especificados. Por ejemplo: file |
away | object | No | Configura una respuesta automática para las horas o días de ausencia, cuando estás fuera del horario laboral. Puedes configurar los días de la semana y el horario de apertura en los que tu equipo está disponible. Cualquier usuario que te contacte fuera del horario laboral configurado recibirá un mensaje automático. Nota: si usas WhatsApp Business, asegúrate de haber desactivado las respuestas automáticas en la aplicación de WhatsApp; de lo contrario, podrías tener conflictos al enviar respuestas automáticas. |
away.active | ['boolean', 'null'] | Sí | Activa o desactiva el mensaje de respuesta automática de ausencia |
away.message | ['string', 'null'] | Sí | Mensaje que se enviará como respuesta automática de ausencia, hasta 3000 caracteres. minLength: 5 · maxLength: 3000 |
away.file | ['string', 'null'] | No | ID opcional de un archivo de imagen (24 caracteres hexadecimales) que se enviará como respuesta automática. El archivo de imagen debe haberse subido previamente al sistema. Solo se pueden enviar imágenes como respuestas automáticas, con un tamaño de archivo de hasta 2 MB. Omítelo para conservar la imagen actual. Para eliminarla, envía null o incluye file en remove. minLength: 24 · maxLength: 24 · pattern: ^[0-9a-fA-F]{24}$ |
away.target | string | No | Destino opcional del mensaje de ausencia: usa all para responder a cualquier chat nuevo, o usa new_contacts para responder solo a los chats nuevos iniciados por números que no están en tu agenda de contactos. enum: ['all', 'new_contacts'] · default: all |
away.skipPending | boolean | No | Indicador opcional para omitir el envío del mensaje de ausencia a chats pendientes (chats que aún no han sido respondidos, asignados ni resueltos). |
away.skipResolved | boolean | No | Indicador opcional para omitir el envío del mensaje de bienvenida a chats que han sido resueltos. Los chats resueltos son chats que han sido cerrados por el usuario o por el sistema. |
away.skipAssigned | boolean | No | Indicador opcional para omitir el envío del mensaje de bienvenida a chats que han sido asignados a un agente y no han sido resueltos, eliminados ni bloqueados. Los chats asignados son chats que han sido asignados a un agente por el sistema o manualmente por un agente. |
away.skipNumbers | array<string> | No | Lista opcional de números de teléfono que se ignorarán al enviar el mensaje de bienvenida. El número de teléfono debe estar en formato E.164, por ejemplo: +16001234560 |
away.timezone | string | No | Zona horaria local que se aplicará al horario laboral de apertura por día de la semana. Si no se define, se usará de forma predeterminada la configuración de zona horaria de la cuenta. enum: ['Africa/Abidjan', 'Africa/Accra', 'Africa/Addis_Ababa', 'Africa/Algiers', 'Africa/Asmara', 'Africa/Asmera', 'Africa/Bamako', 'Africa/Bangui', 'Africa/Banjul', 'Africa/Bissau', 'Africa/Blantyre', 'Africa/Brazzaville', 'Africa/Bujumbura', 'Africa/Cairo', 'Africa/Casablanca', 'Africa/Ceuta', 'Africa/Conakry', 'Africa/Dakar', 'Africa/Dar_es_Salaam', 'Africa/Djibouti', 'Africa/Douala', 'Africa/El_Aaiun', 'Africa/Freetown', 'Africa/Gaborone', 'Africa/Harare', 'Africa/Johannesburg', 'Africa/Juba', 'Africa/Kampala', 'Africa/Khartoum', 'Africa/Kigali', 'Africa/Kinshasa', 'Africa/Lagos', 'Africa/Libreville', 'Africa/Lome', 'Africa/Luanda', 'Africa/Lubumbashi', 'Africa/Lusaka', 'Africa/Malabo', 'Africa/Maputo', 'Africa/Maseru', 'Africa/Mbabane', 'Africa/Mogadishu', 'Africa/Monrovia', 'Africa/Nairobi', 'Africa/Ndjamena', 'Africa/Niamey', 'Africa/Nouakchott', 'Africa/Ouagadougou', 'Africa/Porto-Novo', 'Africa/Sao_Tome', 'Africa/Timbuktu', 'Africa/Tripoli', 'Africa/Tunis', 'Africa/Windhoek', 'America/Adak', 'America/Anchorage', 'America/Anguilla', 'America/Antigua', 'America/Araguaina', 'America/Argentina/Buenos_Aires', 'America/Argentina/Catamarca', 'America/Argentina/ComodRivadavia', 'America/Argentina/Cordoba', 'America/Argentina/Jujuy', 'America/Argentina/La_Rioja', 'America/Argentina/Mendoza', 'America/Argentina/Rio_Gallegos', 'America/Argentina/Salta', 'America/Argentina/San_Juan', 'America/Argentina/San_Luis', 'America/Argentina/Tucuman', 'America/Argentina/Ushuaia', 'America/Aruba', 'America/Asuncion', 'America/Atikokan', 'America/Atka', 'America/Bahia', 'America/Bahia_Banderas', 'America/Barbados', 'America/Belem', 'America/Belize', 'America/Blanc-Sablon', 'America/Boa_Vista', 'America/Bogota', 'America/Boise', 'America/Buenos_Aires', 'America/Cambridge_Bay', 'America/Campo_Grande', 'America/Cancun', 'America/Caracas', 'America/Catamarca', 'America/Cayenne', 'America/Cayman', 'America/Chicago', 'America/Chihuahua', 'America/Ciudad_Juarez', 'America/Coral_Harbour', 'America/Cordoba', 'America/Costa_Rica', 'America/Creston', 'America/Cuiaba', 'America/Curacao', 'America/Danmarkshavn', 'America/Dawson', 'America/Dawson_Creek', 'America/Denver', 'America/Detroit', 'America/Dominica', 'America/Edmonton', 'America/Eirunepe', 'America/El_Salvador', 'America/Ensenada', 'America/Fort_Nelson', 'America/Fort_Wayne', 'America/Fortaleza', 'America/Glace_Bay', 'America/Godthab', 'America/Goose_Bay', 'America/Grand_Turk', 'America/Grenada', 'America/Guadeloupe', 'America/Guatemala', 'America/Guayaquil', 'America/Guyana', 'America/Halifax', 'America/Havana', 'America/Hermosillo', 'America/Indiana/Indianapolis', 'America/Indiana/Knox', 'America/Indiana/Marengo', 'America/Indiana/Petersburg', 'America/Indiana/Tell_City', 'America/Indiana/Vevay', 'America/Indiana/Vincennes', 'America/Indiana/Winamac', 'America/Indianapolis', 'America/Inuvik', 'America/Iqaluit', 'America/Jamaica', 'America/Jujuy', 'America/Juneau', 'America/Kentucky/Louisville', 'America/Kentucky/Monticello', 'America/Knox_IN', 'America/Kralendijk', 'America/La_Paz', 'America/Lima', 'America/Los_Angeles', 'America/Louisville', 'America/Lower_Princes', 'America/Maceio', 'America/Managua', 'America/Manaus', 'America/Marigot', 'America/Martinique', 'America/Matamoros', 'America/Mazatlan', 'America/Mendoza', 'America/Menominee', 'America/Merida', 'America/Metlakatla', 'America/Mexico_City', 'America/Miquelon', 'America/Moncton', 'America/Monterrey', 'America/Montevideo', 'America/Montreal', 'America/Montserrat', 'America/Nassau', 'America/New_York', 'America/Nipigon', 'America/Nome', 'America/Noronha', 'America/North_Dakota/Beulah', 'America/North_Dakota/Center', 'America/North_Dakota/New_Salem', 'America/Nuuk', 'America/Ojinaga', 'America/Panama', 'America/Pangnirtung', 'America/Paramaribo', 'America/Phoenix', 'America/Port-au-Prince', 'America/Port_of_Spain', 'America/Porto_Acre', 'America/Porto_Velho', 'America/Puerto_Rico', 'America/Punta_Arenas', 'America/Rainy_River', 'America/Rankin_Inlet', 'America/Recife', 'America/Regina', 'America/Resolute', 'America/Rio_Branco', 'America/Rosario', 'America/Santa_Isabel', 'America/Santarem', 'America/Santiago', 'America/Santo_Domingo', 'America/Sao_Paulo', 'America/Scoresbysund', 'America/Shiprock', 'America/Sitka', 'America/St_Barthelemy', 'America/St_Johns', 'America/St_Kitts', 'America/St_Lucia', 'America/St_Thomas', 'America/St_Vincent', 'America/Swift_Current', 'America/Tegucigalpa', 'America/Thule', 'America/Thunder_Bay', 'America/Tijuana', 'America/Toronto', 'America/Tortola', 'America/Vancouver', 'America/Virgin', 'America/Whitehorse', 'America/Winnipeg', 'America/Yakutat', 'America/Yellowknife', 'Antarctica/Casey', 'Antarctica/Davis', 'Antarctica/DumontDUrville', 'Antarctica/Macquarie', 'Antarctica/Mawson', 'Antarctica/McMurdo', 'Antarctica/Palmer', 'Antarctica/Rothera', 'Antarctica/South_Pole', 'Antarctica/Syowa', 'Antarctica/Troll', 'Antarctica/Vostok', 'Arctic/Longyearbyen', 'Asia/Aden', 'Asia/Almaty', 'Asia/Amman', 'Asia/Anadyr', 'Asia/Aqtau', 'Asia/Aqtobe', 'Asia/Ashgabat', 'Asia/Ashkhabad', 'Asia/Atyrau', 'Asia/Baghdad', 'Asia/Bahrain', 'Asia/Baku', 'Asia/Bangkok', 'Asia/Barnaul', 'Asia/Beirut', 'Asia/Bishkek', 'Asia/Brunei', 'Asia/Calcutta', 'Asia/Chita', 'Asia/Choibalsan', 'Asia/Chongqing', 'Asia/Chungking', 'Asia/Colombo', 'Asia/Dacca', 'Asia/Damascus', 'Asia/Dhaka', 'Asia/Dili', 'Asia/Dubai', 'Asia/Dushanbe', 'Asia/Famagusta', 'Asia/Gaza', 'Asia/Harbin', 'Asia/Hebron', 'Asia/Ho_Chi_Minh', 'Asia/Hong_Kong', 'Asia/Hovd', 'Asia/Irkutsk', 'Asia/Istanbul', 'Asia/Jakarta', 'Asia/Jayapura', 'Asia/Jerusalem', 'Asia/Kabul', 'Asia/Kamchatka', 'Asia/Karachi', 'Asia/Kashgar', 'Asia/Kathmandu', 'Asia/Katmandu', 'Asia/Khandyga', 'Asia/Kolkata', 'Asia/Krasnoyarsk', 'Asia/Kuala_Lumpur', 'Asia/Kuching', 'Asia/Kuwait', 'Asia/Macao', 'Asia/Macau', 'Asia/Magadan', 'Asia/Makassar', 'Asia/Manila', 'Asia/Muscat', 'Asia/Nicosia', 'Asia/Novokuznetsk', 'Asia/Novosibirsk', 'Asia/Omsk', 'Asia/Oral', 'Asia/Phnom_Penh', 'Asia/Pontianak', 'Asia/Pyongyang', 'Asia/Qatar', 'Asia/Qostanay', 'Asia/Qyzylorda', 'Asia/Rangoon', 'Asia/Riyadh', 'Asia/Saigon', 'Asia/Sakhalin', 'Asia/Samarkand', 'Asia/Seoul', 'Asia/Shanghai', 'Asia/Singapore', 'Asia/Srednekolymsk', 'Asia/Taipei', 'Asia/Tashkent', 'Asia/Tbilisi', 'Asia/Tehran', 'Asia/Tel_Aviv', 'Asia/Thimbu', 'Asia/Thimphu', 'Asia/Tokyo', 'Asia/Tomsk', 'Asia/Ujung_Pandang', 'Asia/Ulaanbaatar', 'Asia/Ulan_Bator', 'Asia/Urumqi', 'Asia/Ust-Nera', 'Asia/Vientiane', 'Asia/Vladivostok', 'Asia/Yakutsk', 'Asia/Yangon', 'Asia/Yekaterinburg', 'Asia/Yerevan', 'Atlantic/Azores', 'Atlantic/Bermuda', 'Atlantic/Canary', 'Atlantic/Cape_Verde', 'Atlantic/Faeroe', 'Atlantic/Faroe', 'Atlantic/Jan_Mayen', 'Atlantic/Madeira', 'Atlantic/Reykjavik', 'Atlantic/South_Georgia', 'Atlantic/St_Helena', 'Atlantic/Stanley', 'Australia/ACT', 'Australia/Adelaide', 'Australia/Brisbane', 'Australia/Broken_Hill', 'Australia/Canberra', 'Australia/Currie', 'Australia/Darwin', 'Australia/Eucla', 'Australia/Hobart', 'Australia/LHI', 'Australia/Lindeman', 'Australia/Lord_Howe', 'Australia/Melbourne', 'Australia/NSW', 'Australia/North', 'Australia/Perth', 'Australia/Queensland', 'Australia/South', 'Australia/Sydney', 'Australia/Tasmania', 'Australia/Victoria', 'Australia/West', 'Australia/Yancowinna', 'Brazil/Acre', 'Brazil/DeNoronha', 'Brazil/East', 'Brazil/West', 'CET', 'CST6CDT', 'Canada/Atlantic', 'Canada/Central', 'Canada/Eastern', 'Canada/Mountain', 'Canada/Newfoundland', 'Canada/Pacific', 'Canada/Saskatchewan', 'Canada/Yukon', 'Chile/Continental', 'Chile/EasterIsland', 'Cuba', 'EET', 'EST', 'EST5EDT', 'Egypt', 'Eire', 'Etc/GMT', 'Etc/GMT+0', 'Etc/GMT+1', 'Etc/GMT+10', 'Etc/GMT+11', 'Etc/GMT+12', 'Etc/GMT+2', 'Etc/GMT+3', 'Etc/GMT+4', 'Etc/GMT+5', 'Etc/GMT+6', 'Etc/GMT+7', 'Etc/GMT+8', 'Etc/GMT+9', 'Etc/GMT-0', 'Etc/GMT-1', 'Etc/GMT-10', 'Etc/GMT-11', 'Etc/GMT-12', 'Etc/GMT-13', 'Etc/GMT-14', 'Etc/GMT-2', 'Etc/GMT-3', 'Etc/GMT-4', 'Etc/GMT-5', 'Etc/GMT-6', 'Etc/GMT-7', 'Etc/GMT-8', 'Etc/GMT-9', 'Etc/GMT0', 'Etc/Greenwich', 'Etc/UCT', 'Etc/UTC', 'Etc/Universal', 'Etc/Zulu', 'Europe/Amsterdam', 'Europe/Andorra', 'Europe/Astrakhan', 'Europe/Athens', 'Europe/Belfast', 'Europe/Belgrade', 'Europe/Berlin', 'Europe/Bratislava', 'Europe/Brussels', 'Europe/Bucharest', 'Europe/Budapest', 'Europe/Busingen', 'Europe/Chisinau', 'Europe/Copenhagen', 'Europe/Dublin', 'Europe/Gibraltar', 'Europe/Guernsey', 'Europe/Helsinki', 'Europe/Isle_of_Man', 'Europe/Istanbul', 'Europe/Jersey', 'Europe/Kaliningrad', 'Europe/Kiev', 'Europe/Kirov', 'Europe/Kyiv', 'Europe/Lisbon', 'Europe/Ljubljana', 'Europe/London', 'Europe/Luxembourg', 'Europe/Madrid', 'Europe/Malta', 'Europe/Mariehamn', 'Europe/Minsk', 'Europe/Monaco', 'Europe/Moscow', 'Europe/Nicosia', 'Europe/Oslo', 'Europe/Paris', 'Europe/Podgorica', 'Europe/Prague', 'Europe/Riga', 'Europe/Rome', 'Europe/Samara', 'Europe/San_Marino', 'Europe/Sarajevo', 'Europe/Saratov', 'Europe/Simferopol', 'Europe/Skopje', 'Europe/Sofia', 'Europe/Stockholm', 'Europe/Tallinn', 'Europe/Tirane', 'Europe/Tiraspol', 'Europe/Ulyanovsk', 'Europe/Uzhgorod', 'Europe/Vaduz', 'Europe/Vatican', 'Europe/Vienna', 'Europe/Vilnius', 'Europe/Volgograd', 'Europe/Warsaw', 'Europe/Zagreb', 'Europe/Zaporozhye', 'Europe/Zurich', 'GB', 'GB-Eire', 'GMT', 'GMT+0', 'GMT-0', 'GMT0', 'Greenwich', 'HST', 'Hongkong', 'Iceland', 'Indian/Antananarivo', 'Indian/Chagos', 'Indian/Christmas', 'Indian/Cocos', 'Indian/Comoro', 'Indian/Kerguelen', 'Indian/Mahe', 'Indian/Maldives', 'Indian/Mauritius', 'Indian/Mayotte', 'Indian/Reunion', 'Iran', 'Israel', 'Jamaica', 'Japan', 'Kwajalein', 'Libya', 'MET', 'MST', 'MST7MDT', 'Mexico/BajaNorte', 'Mexico/BajaSur', 'Mexico/General', 'NZ', 'NZ-CHAT', 'Navajo', 'PRC', 'PST8PDT', 'Pacific/Apia', 'Pacific/Auckland', 'Pacific/Bougainville', 'Pacific/Chatham', 'Pacific/Chuuk', 'Pacific/Easter', 'Pacific/Efate', 'Pacific/Enderbury', 'Pacific/Fakaofo', 'Pacific/Fiji', 'Pacific/Funafuti', 'Pacific/Galapagos', 'Pacific/Gambier', 'Pacific/Guadalcanal', 'Pacific/Guam', 'Pacific/Honolulu', 'Pacific/Johnston', 'Pacific/Kanton', 'Pacific/Kiritimati', 'Pacific/Kosrae', 'Pacific/Kwajalein', 'Pacific/Majuro', 'Pacific/Marquesas', 'Pacific/Midway', 'Pacific/Nauru', 'Pacific/Niue', 'Pacific/Norfolk', 'Pacific/Noumea', 'Pacific/Pago_Pago', 'Pacific/Palau', 'Pacific/Pitcairn', 'Pacific/Pohnpei', 'Pacific/Ponape', 'Pacific/Port_Moresby', 'Pacific/Rarotonga', 'Pacific/Saipan', 'Pacific/Samoa', 'Pacific/Tahiti', 'Pacific/Tarawa', 'Pacific/Tongatapu', 'Pacific/Truk', 'Pacific/Wake', 'Pacific/Wallis', 'Pacific/Yap', 'Poland', 'Portugal', 'ROC', 'ROK', 'Singapore', 'Turkey', 'UCT', 'US/Alaska', 'US/Aleutian', 'US/Arizona', 'US/Central', 'US/East-Indiana', 'US/Eastern', 'US/Hawaii', 'US/Indiana-Starke', 'US/Michigan', 'US/Mountain', 'US/Pacific', 'US/Samoa', 'UTC', 'Universal', 'W-SU', 'WET', 'Zulu'] · minLength: 2 · maxLength: 40 |
away.useBusinessProfile | boolean | No | Usa la información sincronizada del horario de apertura del perfil de WhatsApp Business. Esta opción solo se puede usar si el número conectado es de WhatsApp Business. Si no hay información de horario de apertura en el perfil, se aplicará la política de apertura 24 horas. |
away.businessHours | object | No | |
away.labels | array<string> | No | Lista opcional de etiquetas de chat que los chats deben tener (al menos una coincidencia) para enviar al usuario el mensaje de respuesta automática de ausencia. |
away.setLabels | array<string> | No | Lista opcional de etiquetas de chat que se añadirán cuando se responda automáticamente a un chat. |
away.exceptions | array<object> | No | Lista opcional de excepciones al horario laboral de apertura por día de la semana, que pueden ser festivos, celebraciones nacionales o días especiales de apertura 24 horas. |
away.remove | array<string> | No | Elimina opcionalmente los valores de los campos especificados. Por ejemplo: file |
busy | object | No | Configura una respuesta automática para los momentos de alta ocupación, cuando tu equipo necesita más tiempo para responder a los chats nuevos. Puedes configurar el plazo en minutos tras el cual se enviará el mensaje de ocupado si nadie puede responder al chat nuevo antes de ese plazo, por ejemplo: 5 minutos. Nota: la respuesta automática de ocupado solo está disponible en los planes Business y Enterprise |
busy.active | ['boolean', 'null'] | Sí | Activa o desactiva el mensaje de respuesta automática de ocupado |
busy.message | ['string', 'null'] | No | Mensaje que se enviará como respuesta automática de ocupado, hasta 3000 caracteres. minLength: 0 · maxLength: 3000 |
busy.file | ['string', 'null'] | No | ID opcional de un archivo de imagen (24 caracteres hexadecimales) que se enviará como respuesta automática. El archivo de imagen debe haberse subido previamente al sistema. Solo se pueden enviar imágenes como respuestas automáticas, con un tamaño de archivo de hasta 2 MB. Omítelo para conservar la imagen actual. Para eliminarla, envía null o incluye file en remove. minLength: 24 · maxLength: 24 · pattern: ^[0-9a-fA-F]{24}$ |
busy.target | string | No | Destino opcional del mensaje de ocupado: usa all para responder a cualquier chat nuevo, o usa new_contacts para responder solo a los chats nuevos iniciados por números que no están en tu agenda de contactos. enum: ['all', 'new_contacts'] · default: all |
busy.timeframe | string | No | Plazo opcional para el mensaje de ocupado: usa 5m para enviar el mensaje de ocupado en chats que no fueron respondidos en los 5 minutos posteriores al último mensaje, o usa un plazo distinto según las opciones disponibles. enum: ['3m', '5m', '10m', '15m', '20m', '30m'] · default: 5m |
busy.setLabels | array<string> | No | Lista opcional de etiquetas de chat que se añadirán cuando se responda automáticamente a un chat. |
busy.skipPending | boolean | No | Indicador opcional para omitir el envío del mensaje de ocupado a chats pendientes (chats que aún no han sido respondidos, asignados ni resueltos). |
busy.skipResolved | boolean | No | Indicador opcional para omitir el envío del mensaje de ocupado a chats que han sido resueltos. Los chats resueltos son chats que han sido cerrados por el usuario o por el sistema. |
busy.skipAssigned | boolean | No | Indicador opcional para omitir el envío del mensaje de ocupado a chats que han sido asignados a un agente y no han sido resueltos, eliminados ni bloqueados. Los chats asignados son chats que han sido asignados a un agente por el sistema o manualmente por un agente. |
busy.skipNumbers | array<string> | No | Lista opcional de números de teléfono que se ignorarán al enviar el mensaje de bienvenida. El número de teléfono debe estar en formato E.164, por ejemplo: +16001234560 |
busy.remove | array<string> | No | Elimina opcionalmente los valores de los campos especificados. Por ejemplo: file |
follow | array<object> | No | Configura una respuesta automática para mensajes de seguimiento, cuando quieras actualizar al cliente o recopilar comentarios del usuario. Puedes configurar el plazo tras el cual se enviará el mensaje de seguimiento si no se intercambió ningún mensaje durante ese plazo. Por ejemplo: 24 horas. Nota: la respuesta automática de seguimiento solo está disponible en los planes Business y Enterprise |
call | object | No | Configura una respuesta automática para llamadas entrantes, con el fin de avisar al usuario de que no aceptas llamadas de voz y ofrecerle información útil sobre formas alternativas de comunicarse. Nota: la respuesta automática de llamadas solo está disponible en los planes Business y Enterprise |
call.active | ['boolean', 'null'] | Sí | Activa o desactiva el mensaje de respuesta automática de llamadas |
call.message | ['string', 'null'] | Sí | Mensaje que se enviará como respuesta automática de bienvenida, hasta 3000 caracteres. minLength: 5 · maxLength: 3000 |
call.file | ['string', 'null'] | No | ID opcional de un archivo de imagen (24 caracteres hexadecimales) que se enviará como respuesta automática. El archivo de imagen debe haberse subido previamente al sistema. Solo se pueden enviar imágenes como respuestas automáticas, con un tamaño de archivo de hasta 2 MB. Omítelo para conservar la imagen actual. Para eliminarla, envía null o incluye file en remove. minLength: 24 · maxLength: 24 · pattern: ^[0-9a-fA-F]{24}$ |
call.reject | ['boolean', 'null'] | Sí | Establécelo en true para rechazar todas las llamadas automáticamente. |
call.setLabels | array<string> | No | Lista opcional de etiquetas de chat que se añadirán cuando se responda automáticamente a un chat. |
call.skipNumbers | array<string> | No | Lista opcional de números de teléfono que se ignorarán al enviar el mensaje de bienvenida. El número de teléfono debe estar en formato E.164, por ejemplo: +16001234560 |
call.remove | array<string> | No | Elimina opcionalmente los valores de los campos especificados. Por ejemplo: file |
Respuestas
| Código | Descripción |
|---|---|
200 | Respuestas automáticas actualizadas |
400 | Campos del cuerpo inválidos o faltantes |
401 | Acceso no autorizado por un token de API inválido o vencido |
403 | Usuario no autorizado o falta el token de API requerido |
404 | Número no encontrado |
409 | Conflicto: función no compatible, archivo de respuesta automática o configuración inválidos |
429 | Demasiadas solicitudes: inténtalo de nuevo más tarde |
500 | Error inesperado |
501 | No implementado |
503 | Servicio temporalmente no disponible: inténtalo de nuevo más tarde |