Actions115
- Teams Actions
- Account Users Actions
- Custom Attributes Actions
- Contacts Actions
- Conversation Labels Actions
- Reports Actions
- Accounts Actions
- Contact Actions
- Agent Bots Actions
- Users Actions
- Inbox API Actions
- Contacts API Actions
- Conversations API Actions
- Messages API Actions
- CSAT Survey Page Actions
- Account Agent Bots Actions
- Agents Actions
- Canned Responses Actions
- Canned Response Actions
- Messages Actions
- Automation Rule Actions
- Help Center Actions
- Conversations Actions
- Conversation Assignment Actions
- Inboxes Actions
- Integrations Actions
- Profile Actions
- Custom Filters Actions
- Webhooks Actions
Overview
This node operation adds a new agent to a specified account in the Konverte Digital system. It is useful for managing user roles and availability within an account, such as adding support agents or administrators. Practical examples include onboarding new team members to a customer support platform or updating agent availability settings automatically.
Use Case Examples
- Add a new support agent to an account with their name, email, and role specified.
- Set an agent's availability status to 'busy' or 'offline' automatically based on their activity.
- Configure an agent to go offline automatically when away using the auto offline setting.
Properties
| Name | Meaning |
|---|---|
| Account Id | The numeric ID of the account to which the new agent will be added. |
| Name | Full name of the agent being added. |
| Email address of the agent. | |
| Role | Role of the agent, either 'agent' or 'administrator'. |
| Availability Status | The availability setting of the agent, such as available, busy, or offline. |
| Auto Offline | Whether the agent's availability status is configured to go offline automatically when away. |
| Request Options | Additional request settings such as batching, SSL certificate validation, proxy, and timeout. |
Output
JSON
id- Unique identifier of the newly created agent.account_id- The account ID to which the agent was added.name- Full name of the agent.email- Email address of the agent.role- Role assigned to the agent.availability_status- Current availability status of the agent.auto_offline- Boolean indicating if the agent is set to go offline automatically when away.
Dependencies
- Requires an API key credential for authentication with the Konverte Digital API.
Troubleshooting
- Ensure the 'Account Id' is a valid numeric ID corresponding to an existing account.
- Verify that the email address is correctly formatted and not already in use.
- Check API credentials and base URL configuration to avoid authentication errors.
- If SSL issues occur, consider enabling the 'Ignore SSL Issues' option, but be aware of security risks.
- Timeout errors may occur if the server is slow; adjust the timeout setting accordingly.
Links
- Konverte Digital API Documentation - Agents - Official API documentation for managing agents in Konverte Digital.