You are viewing the Spanish (Mexico) site, but your language preference is set to English. Switch to English site →

Menu

Expand
Calificar esta página:

Recurso de conferencia

El recurso de conferencia te permite consultar y gestionar el estado de las conferencias en tu cuenta de Twilio.

Las salas de conferencias no se crean directamente desde la API de Programmable Voice.

Para crear una nueva conferencia, debes usar el verbo <Dial> de TwiML con el sustantivo <Conference>. Después de crear una instancia de conferencia , puedes acceder a ella mediante la API REST.

Para obtener instrucciones paso a paso sobre cómo escribir este TwiML y gestionar la conferencia mediante programación, consulta nuestras guías sobre cómo crear llamadas de conferencia mediante las bibliotecas auxiliares compatibles con Twilio.

Conference properties

Resource Properties in REST API format
account_sid
sid<AC> Not PII

SID de la Cuenta que creó el recurso de conferencia.

date_created
date_time<rfc2822> Not PII

The date and time in GMT that this resource was created specified in RFC 2822 format.

date_updated
date_time<rfc2822> Not PII

The date and time in GMT that this resource was last updated, specified in RFC 2822 format.

api_version
string Not PII

La versión de la API utilizada para crear esta conferencia.

friendly_name
string Not PII

La cadena que asignaste para describir esta sala de conferencias.

region
string Not PII

Una cadena que representa la región de Twilio donde se mezcló el audio de la conferencia. Puede ser “us1”, “ie1”, “de1”, “sg1”, “br1”, “au1” y “jp1”. El audio de conferencia básico siempre se mezclará en “us1”. El audio de la conferencia global se mezclará en el lugar más cercano a la mayoría de los participantes.

sid
sid<CF> Not PII

La cadena única que creamos para identificar el recurso de conferencia.

status
enum:status Not PII

El estado de esta conferencia. Puede ser: “init”, “in-progress” (en curso) o “completed” (completado).

uri
string Not PII

The URI of this resource, relative to https://api.twilio.com.

subresource_uris
uri_map Not PII

Una lista de recursos relacionados identificados por sus URI en relación con “https://api.twilio.com”.

reason_conference_ended
enum:reason_conference_ended Not PII

El motivo por el que finalizó una conferencia. Cuando una conferencia está en curso, será “null” (nulo). Una vez finalizada la conferencia, puede ser: “conference-ended-via-api”, “participant-with-end-conference-on-exit-left”, “participant-with-end-conference-on-exit-kicked”, “last-participant-kicked” o “last-participant-left”.

call_sid_ending_conference
sid<CA> Not PII

El SID de llamada que provocó la finalización de la conferencia.

Es posible que tengas muchas instancias de conferencia que compartan el mismo friendly_name. Solo una de estas distintas conferencias puede estar en curso en un momento dado. Por ejemplo, si tienes dos conferencias independientes con el friendly_name "my-conference" no puedes agregar participantes a una instancia mientras la otra está en curso.

Fetch a Conference resource

get
https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Conferences/{Sid}.json

La forma recomendada de supervisar el estado de una conferencia y de sus participantes es utilizar el statusCallback de la conferencia. Esta devolución de llamada de webhook se activará cuando cambie el estado de la conferencia o de un participante.

Puedes utilizar la API REST en cualquier momento para consultar los recursos de conferencia y participante; sin embargo, no se recomienda sondear continuamente estos recursos.

Parameters
Parameters in REST API format
account_sid
Path
get sid<AC> Not PII

SID de la Cuenta que creó los recursos de conferencia que se recuperarán.

sid
Path
get sid<CF> Not PII

La cadena proporcionada por Twilio que identifica de forma única el recurso de conferencia que se recuperará

Example 1
        
        
        

        Recuperar un recurso de conferencia

        Read multiple Conference resources

        get
        https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Conferences.json

        Leer todas las conferencias de tu cuenta.

        La lista de conferencias que devolvemos incluye la información de paginación.

        Parameters
        Parameters in REST API format
        account_sid
        Path
        get sid<AC> Not PII

        El SID de la Cuenta que creó los recursos de conferencia que se leerán.

        date_created
        Optional
        get date_inequality<iso8601> Not PII

        El valor “date_created”, especificado como “AAAA-MM-DD”, de los recursos que se van a leer. Para leer conferencias que comenzaron en la medianoche de una fecha o antes de ella, utiliza “<=AAAA-MM-DD” , y para especificar conferencias que comenzaron en la medianoche de una fecha o después de ella, utiliza “>=AAAA-MM-DD”.

        date_updated
        Optional
        get date_inequality<iso8601> Not PII

        El valor “date_updated”, especificado como “AAAA-MM-DD”, de los recursos que se van a leer. Para leer conferencias que se actualizaron por última vez en la medianoche de una fecha o antes de ella, utiliza “<=AAAA-MM-DD”, y para especificar conferencias que se actualizaron por última vez en la medianoche de una fecha o después de ella, utiliza “>=AAAA-MM-DD”.

        friendly_name
        Optional
        get string Not PII

        La cadena que identifica los recursos de conferencia que se van a leer.

        status
        Optional
        get enum:status Not PII

        El estado de los recursos que se van a leer. Puede ser: “init”, “in-progress” (en curso) o “completed” (completado).

        Example 1
              
              
              
              Devuelve la lista de todas las conferencias de la cuenta

              Leer varios recursos de conferencia

              Devuelve la lista de todas las conferencias de la cuenta
              Example 2
                    
                    
                    
                    Devuelve una lista de las conferencias que comenzaron el 07 de julio del 2020

                    Leer las conferencias que comenzaron en una fecha específica

                    Devuelve una lista de las conferencias que comenzaron el 07 de julio del 2020
                    Example 3
                          
                          
                          
                          Devuelve una lista de las conferencias en curso que se iniciaron a la medianoche del 1 de enero del 2021 o después de esa fecha

                          Leer las conferencias en curso que se crearon en una fecha específica o después de ella

                          Devuelve una lista de las conferencias en curso que se iniciaron a la medianoche del 1 de enero del 2021 o después de esa fecha
                          Example 4
                                
                                
                                
                                Devuelve las conferencias denominadas “MyRoom”

                                Leer las conferencias denominadas “MyRoom”

                                Devuelve las conferencias denominadas “MyRoom”

                                Update a Conference resource

                                post
                                https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Conferences/{Sid}.json

                                Puedes utilizar la acción de actualización para cambiar las propiedades de la conferencia, así como para finalizarla.

                                Parameters
                                Parameters in REST API format
                                account_sid
                                Path
                                post sid<AC> Not PII

                                El SID de la Cuenta que creó los recursos de conferencia que se actualizarán.

                                sid
                                Path
                                post sid_like<CF> Not PII

                                La cadena proporcionada por Twilio que identifica de forma única el recurso de conferencia que se actualizará

                                status
                                Optional
                                post enum:update_status Not PII

                                El nuevo estado del recurso. Puede ser: Puede ser: “init”, “in-progress” (en curso) o “completed” (completado). Si se especifica “completed”, se finalizará la conferencia y se colgará la llamada a todos los participantes

                                announce_url
                                Optional
                                post url Not PII

                                The URL we should call to announce something into the conference. The URL may return an MP3 file, a WAV file, or a TwiML document that contains <Play>, <Say>, <Pause>, or <Redirect> verbs.

                                announce_method
                                Optional
                                post http_method Not PII

                                El método HTTP utilizado para llamar a “announce_url”. Puede ser: “GET” o “POST”, y el valor predeterminado es “POST”

                                Example 1
                                      
                                      
                                      
                                      Finalizar esta conferencia mediante el establecimiento de su estado en “completed” (completada).

                                      Actualizar una conferencia para finalizarla

                                      Finalizar esta conferencia mediante el establecimiento de su estado en “completed” (completada).
                                      Example 2
                                            
                                            
                                            
                                            Incluir el parámetro AnnounceUrl a fin de reproducir algo para los participantes de la conferencia.

                                            Actualizar una conferencia para anunciar algo

                                            Incluir el parámetro AnnounceUrl a fin de reproducir algo para los participantes de la conferencia.

                                            Gestionar participantes de la conferencia

                                            Cada conferencia tiene un subrecurso de participantes. Los participantes representan el conjunto de personas conectadas actualmente a una conferencia en curso.

                                            Para solicitar a todos los participantes de una conferencia determinada, solicita esto:

                                            GET https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Conferences/{ConferenceSid}/Participants.json

                                            Consulta la documentación completa de referencia de la API de participantes para conocer las propiedades, los parámetros y las acciones de los participantes.

                                            Grabaciones de conferencias

                                            Puedes acceder al subrecurso de lista grabaciones en cualquier conferencia determinada.

                                            El ejemplo a continuación devolverá una lista de todas las grabaciones generadas para una conferencia determinada, identificadas por su ConferenceSid. (Ten en cuenta que no se devolverán las grabaciones asociadas a un tramo de llamada individual de la conferencia).

                                            GET https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/Conferences/{ConferenceSid}/Recordings.json

                                            Consulta la documentación de referencia de grabaciones para obtener información sobre las propiedades de los recursos y los formatos de respuesta.

                                            Retención del registro de conferencias

                                            A partir del 5 de febrero del 2021 podrás recuperar recursos a través de GET para los puntos finales /Conferences y /Participants durante 13 meses después de la creación del recurso. Esto representa un cambio significativo, ya que estos registros se almacenan indefinidamente en Twilio y se pueden recuperar a través de la consola y la API.

                                            Es importante tener en cuenta que no estamos eliminando tus registros, sino que simplemente cambiaremosdónde estarán disponibles para ti. Proporcionamos una utilidad de exportación masiva en la consola para los recursos de conferencias y participantes, así como una API. La exportación masiva generará archivos S3 que contienen un día de datos por archivo y enviará el enlace de descarga a través del webhook, el correo electrónico o la consola. Los registros de más de 13 meses solo se podrán recuperar mediante exportación masiva.

                                            Si realizas la extracción de registros a través de la API de forma sucesiva, es importante verificar que extraes los registros con una frecuencia que no se verá afectada por este cambio.

                                            Calificar esta página:

                                            ¿Necesitas ayuda?

                                            Todos la necesitamos a veces; la programación es difícil. Obtén ayuda ahora de nuestro equipo de soporte, o recurre a la sabiduría de la multitud visitando Stack Overflow Collective de Twilio o navegando por la etiqueta de Twilio en Stack Overflow.

                                                  
                                                  
                                                  

                                                  Gracias por tus comentarios.

                                                  Selecciona los motivos de tus comentarios. La información adicional que nos brindas nos ayuda a mejorar nuestra documentación:

                                                  Enviando tus comentarios…
                                                  🎉 Gracias por tus comentarios.
                                                  Se produjo un error. Inténtalo de nuevo.

                                                  Gracias por tus comentarios.

                                                  thanks-feedback-gif