Voip en Español

[[asterisk_manager_api]]

Traza: » asterisk_funcion_zapateller » asterisk_funcion_zapbarge » asterisk_funcion_zapec » asterisk_funcion_zapras » asterisk_funcion_zapscan » asterisk_funcion_zapsendkeypadfacility » asterisk_gui » asterisk_isdn4linux » asterisk_jabber » asterisk_manager_api

Login

¡Actualmente no estás identificado! Introduce abajo tus datos de identificación para abrir una sesión. Necesitas tener las cookies activadas para identificarte.

Ingresar

Has olvidado tu contraseña? Obten una nueva.: Enviar nueva contraseña

El manager API de Asterisk

ARREGLAR

El encargado del asterisco permite que un programa del cliente conecte con un caso del asterisco y los comandos de la edición o lea acontecimientos del PBX sobre una corriente del TCP/IP. Los integradores encontrarán este particularmente útil al intentar para seguir el estado de un cliente de la telefonía dentro del asterisco, y dirigiendo que cliente basado en reglas de encargo (y posiblemente dinámicas).

Una “llave simple: valorar el” protocolo línea-basado se utiliza para la comunicación entre el cliente que conecta y el asterisco PBX. Se terminan las líneas usando CRLF. Por la discusión abajo, utilizaremos “paquete” del término para describir un sistema de la “llave: valorar las” líneas que son terminadas por un retorno del carro adicional.

Nuevo en el asterisco 1.4: AJAM es una nueva tecnología Javascript-basada que permite que los browsers de la tela u otros usos y Web pages permitidos HTTP tengan acceso directamente al interfaz del encargado del asterisco (AMI) vía el HTTP.

Comportamiento del protocolo

El protocolo tiene las características siguientes:

  • Antes de publicar ordena para marcar con asterisco, tú debe establecer una sesión del encargado (véase abajo).
  • Los paquetes se pueden transmitir en cualquier dirección en cualquier momento después de la autentificación.
  • La primera línea de un paquete tendrá una llave de la “acción” cuando está enviada del cliente, pero del “acontecimiento” o de la “respuesta” cuando está enviada de asterisco al cliente.
  • La pedido de líneas dentro de un paquete es insignificante, así que puedes utilizar tu tipo desordenado nativo preferido del diccionario del lenguaje de programación para almacenar eficientemente un solo paquete.
  • CRLF se utiliza para delimitar cada línea y una línea en blanco (dos CRLF en una fila) indica el final del comando que ahora se espera que el asterisco procese.

Tipos del paquete

El tipo de un paquete es determinado por la existencia de una de las llaves siguientes:

  • Acción: Un paquete enviado por el cliente conectado al asterisco, solicitando una acción particular se realice. Hay un finito (pero extensible) fijó de las acciones disponibles para el cliente, determinado por los módulos cargados actualmente en el motor del asterisco. Solamente una acción puede ser excepcional a la vez. El paquete de la acción contiene el nombre de la operación que se realizará tan bien como todos los parámetros requeridos.
  • Respuesta: la respuesta enviada por Asterisk a la acción pasada enviada por el cliente.
  • Acontecimiento: datos referente a un acontecimiento generado dentro de la base del asterisco o de un módulo de la extensión.

El cliente envía generalmente los paquetes de la acción al servidor del asterisco, a los perfoms del servidor del asterisco la operación solicitada y a las vueltas el resultado (a menudo solamente éxito o falta) en un paquete de la respuesta. Pues no hay garantía con respecto a la pedido de los paquetes de la respuesta el cliente incluye generalmente un parámetro de ActionID en cada paquete de la acción que sea enviado detrás por Asterisk en el paquete correspondiente de la respuesta. Esa manera el cliente puede emparejar fácilmente los paquetes de la acción y de la respuesta mientras que envía acciones en cualquier tarifa deseada sin tener que esperar los paquetes excepcionales de la respuesta antes de enviar la acción siguiente.

Los paquetes del acontecimiento se utilizan en dos diversos contextos: En la una mano informan a clientes sobre cambios del estado en asterisco (como los nuevos canales que son creados y colgados para arriba o los agentes que son entrados y hacia fuera) por otra parte que ellos se utilizan transportar la carga útil de la respuesta para las acciones que vuelven una lista de los datos (acontecimiento que genera acciones). Cuando un cliente envía un acontecimiento que genera el asterisco de la acción envía una respuesta embalada indicando éxito y conteniendo una “respuesta: Sigue la” línea. Entonces envía cero o más acontecimiento que contengan la carga útil real y finalmente un acontecimiento completo de la acción que indican que se han enviado todos los datos. Los acontecimientos enviados en respuesta a un acontecimiento que genera la acción y al acontecimiento completo de la acción contienen el ActionID del paquete de la acción que los accionó, así que puedes emparejarlos fácilmente la misma manera que los paquetes de la respuesta. Un ejemplo de un acontecimiento que genera la acción es la acción del estado los acontecimientos de ese estado de los disparadores para cada canal activo. Cuando se han enviado todos los acontecimientos del estado el terminar se envía un acontecimiento de StatusComplete.

Abrir una sesión del encargado y autenticidad como usuario

Para tener acceso a la funcionalidad del encargado del asterisco que un usuario necesita establecer una sesión abriendo una conexión del TCP/IP al puerto que escucha (generalmente 5038) del caso del asterisco y registrándola en el encargado que usa la acción de la “conexión”. Esto requiere una cuenta previamente establecida del usuario en el servidor del asterisco. Las cuentas del usuario se configuran en /etc/asterisk/manager.conf. Una cuenta del usuario consiste en un sistema de anfitriones permitidos del IP, de un secreto de la autentificación (contraseña), y de una lista de permisos concedidos.

Hay un sistema finito de permisos, cada uno se puede conceder con cualquiera “leída”, “escribir”, o granularity “de lectura/grabación”. Si conceden un cliente la capacidad de leer una clase dada, marcar con asterisco te enviará acontecimientos de esa clase. Si conceden un cliente la capacidad de escribir una clase dada, puede enviar acciones de esa clase.

A la conexión y authenticar al encargado, tú debe enviar una acción de la “conexión”, con tu nombre y secreto (contraseña) del usuario como parámetros. Aquí está un ejemplo:

Acción: conexión
Username: admin
Secreto: dios

Si no necesitas suscribir a los acontecimientos que son generados por Asterisk, puedes también incluir los “acontecimientos: del” parámetro, que prevendrá los paquetes del acontecimiento que son enviados a tu conexión. Éste es el equivalente de llamar la acción de los “acontecimientos”. Ejemplo:

Acción: conexión
Username: admin
Secreto: dios
Acontecimientos: de

Paquetes de la acción

Al enviar asterisco una acción, las llaves adicionales se pueden proporcionar a la ejecución directa adicional, por ejemplo, puedes desear especificar un número para llamar, un canal a desconectar. Además, si tu acción hace el asterisco ejecutar una entrada en el dialplan, puedes desear pasar variables al dialplan (disponible en fecha el insecto 1268). Esto se hace exactamente la misma manera que enviarías llaves.

Para enviar asterisco una acción, seguir este formato simple:

 Acción: type><CRLF> del <action
 <Key 1>: <Value 1><CRLF>
 <Key 2>: <Value 2><CRLF>
 ...
 Variable: 1>=<Value <Variable 1><CRLF>
 Variable: 2>=<Value <Variable 2><CRLF>
 ...
 <CRLF>

Acciones del encargado

La salida del encargado de la demostración del comando de CLI ordena:

  • AbsoluteTimeout: Descanso absoluto determinado (privilegio: llamada, toda)
  • ChangeMonitor: Cambiar la supervisión de nombre de fichero de un canal (privilegio: llamar, todo)
  • Comando: Ejecutar el comando (privilegio: ordenar, todo)
  • Acontecimientos: Controlar el flujo del acontecimiento
  • ExtensionState: Comprobar el estado de la extensión (privilegio: llamar, todo)
  • GetVar: Consigue una variable del canal (privilegio: llamada, toda)
  • Retraso: __ del canal del retraso (privilegio: llamada, toda)
  • IAXpeers: Pares de la lista IAX (privilegio: sistema, todo)
  • ListCommands: Comandos disponibles del encargado de la lista
  • Término de sesión: Encargado del término de sesión
  • MailboxCount: Comprobar la cuenta del mensaje de caja (privilegio: llamar, todo)
  • MailboxStatus: Comprobar la caja (privilegio: llamar, todo)
  • Monitor: Supervisar un canal (privilegio: llamar, todo)
  • Originar: Originar la llamada (privilegio: llamar, todo)
  • ParkedCalls: La lista parqueó llamadas
  • Silbido de bala: Silbido de bala
  • QueueAdd: Coletas (privilegio: agente, todo)
  • QueueRemove: Coletas (privilegio: agente, todo)
  • Coletas: Coletas
  • QueueStatus: Estado de la coleta
  • Volver a dirigir: Volver a dirigir (privilegio: llamar, todo)
  • SetCDRUserField: Fijar a CDR UserField (privilegio: llamar, todo)
  • SetVar: Fijar la variable del canal (privilegio: llamar, todo)
  • SIPpeers: Pares del SIP de la lista (chan_sip2 solamente. No disponible en chan_sip en fecha 9/20/2004) (privilegio: sistema, todo)
  • Estado: Estado (privilegio: llamada, toda)
  • StopMonitor: Parar el supervisar de un canal (privilegio: llamar, todo)
  • ZapDialOffhook: El excedente del dial Zap el canal mientras que offhook
  • ZapDNDoff: La palanca Zap el canal no disturba estado APAGADO
  • ZapDNDon: La palanca Zap el canal no disturba estado ENCENDIDO
  • ZapHangup: El retraso Zap el canal
  • ZapTransfer: La transferencia Zap el canal
  • ZapShowChannels: Demostrar Zap los canales

(Nuevo?) en el asterisco 1.2.1 (era la “CABEZA de CVS”) (tomada de la salida del encargado de la demostración del comando de CLI ordena):

  • AgentCallbackLogin: Fija un agente según lo entrado por el servicio repetido (privilegio: agente, todo)
  • AgentLogoff: Fija un agente como entrado no más (privilegio: agente, todo)
  • Agentes: Agentes y su estado (privilegio de las listas: agente, todo)
  • DBGet: Conseguir la entrada del DB (privilegio: sistema, todo)
  • DBPut: Poner la entrada del DB (privilegio: sistema, todo)
  • QueuePause: Hace a miembro de la coleta temporalmente inasequible (privilegio: agente, todo)
  • SIPshowPeer: Demostrar a par del SIP (formato de texto) (privilegio: sistema, todo)

(Nuevo?) en el asterisco 1.2.8

  • PlayDTMF: Señal del juego DTMF en un canal específico. (Privilegio: llamada, toda)

Acontecimientos del asterisco Éstos se enumeran en una página separada: acontecimientos del encargado del asterisco.

Ejemplos del encargado Éstos se enumeran en una página separada también: Ejemplos del encargado del asterisco.

Advertencia

Estamos apesadumbrados, pero si haces usos de una demostración en la consola, verás que el comando de ver a encargados conectados es encargado de la demostración conecta, pero el comando correcto es encargado de la demostración conectado. Anotar por favor él.

Ver también

  • Marcar con asterisco la experiencia del encargado por el mattf
  • Marcar con asterisco los config manager.conf
  • Marcar con asterisco el cmd UserEvent: Enviar un acontecimiento definido por el usario al encargado API
  • Automóvil-dial del asterisco hacia fuera
  • Poder del encargado del asterisco
  • Asterisco-Java
  • OrderlyCalls (sucesor a JAGIServer) ofrece al apoyo total para FastAGI y a encargado en un ambiente nombrado fácil de utilizar de Service. Incluye el Web Deployer para desarrollar usos integrados de VOIP-HTML.
  • Ejemplos del encargado del asterisco
  • acontecimientos del encargado del asterisco