ElevenLabs Agents icon

ElevenLabs Agents

Use agentes de conversação da ElevenLabs

Enviar Mensagem

AI-generated

Overview

This node integrates with ElevenLabs conversational agents, enabling users to manage agents and interact with them through conversation sessions. Specifically, the "Enviar Mensagem" (Send Message) operation allows sending a message to an existing conversation session with an agent. This is useful for automating chat interactions, customer support bots, or any scenario where programmatic dialogue with AI agents is needed.

Practical examples include:

  • Sending user queries to a virtual assistant and receiving responses.
  • Automating follow-up messages in a customer service workflow.
  • Integrating conversational AI into messaging platforms or CRMs.

Properties

Name Meaning
ID da Sessão The unique identifier of the conversation session where the message will be sent.
Mensagem The text message content to send to the agent.
Opções Avançadas Advanced options including:
- Conhecimentos: IDs of knowledge bases (comma-separated).
- Forçar Resposta de Áudio: Force audio response generation.
- Limite de Pesquisa: Max number of search results from knowledge base.
- Idioma: Language code for the session (e.g., pt-BR, en-US).

Output

The node outputs JSON data representing the response from the ElevenLabs API after sending the message. This typically includes the agent's reply and related metadata about the interaction.

If audio response is forced or generated, the output may also include audio data or references to audio content corresponding to the agent's reply.

Dependencies

  • Requires an API key credential for ElevenLabs API authentication.
  • Uses HTTP requests to ElevenLabs endpoints for conversational agents.
  • No additional environment variables are explicitly required beyond the API credential.

Troubleshooting

  • Invalid Session ID: If the session ID does not exist or has expired, the API will return an error. Verify that the session ID is correct and active.
  • Message Not Sent: Ensure the message property is not empty and conforms to expected formats.
  • API Authentication Errors: Check that the API key credential is correctly configured and has necessary permissions.
  • Knowledge Base IDs Format: When specifying knowledge base IDs, ensure they are comma-separated without extra spaces unless trimmed.
  • Language Code Issues: Use valid language codes supported by the API; invalid codes may cause unexpected behavior.
  • Force Audio Response Misuse: Forcing audio response when the agent or session does not support it might lead to errors or no audio returned.

Links and References

Discussion