Trello | ElevenLabs Documentation

Sua recepcionista pode adicionar um cartão a uma lista do Trello quando uma pessoa liga e pede um retorno, um orçamento ou qualquer outra coisa que sua equipe precise acompanhar. Uma ferramenta de webhook cria o cartão pela API REST do Trello.

Antes de começar

Obtenha uma chave de API

Acesse o portal de administração do Power-Up, crie um Power-Up para seu workspace (o nome não importa), abra a aba Trello Auth e selecione Generate a new API key.

Gere um token

Selecione o link Token ao lado da sua chave de API ou abra esta URL em um navegador com sua chave de API no lugar de API_KEY:

https://trello.com/1/authorize?expiration=never&scope=read,write&response_type=token&name=Reception&key=API_KEY

Selecione Allow e copie o token. Ele pode ler e alterar todos os quadros que você pode acessar, então considere gerá-lo com uma conta que seja membro apenas do quadro necessário.

Encontre o ID da lista

Abra o quadro no navegador, adicione .json ao final da URL e carregue a página. Procure o nome da lista; o valor de id ao lado dele é o ID da lista.

Crie a ferramenta de webhook

Vá para Integrações, selecione Adicionar integração e escolha Ferramenta de webhook.

Campo	Valor
Nome	`create_trello_card`
Descrição	”Crie um cartão para a equipe sempre que você prometer à pessoa que ligou um acompanhamento ou quando ela pedir algo que a equipe precisa resolver.”
Método	POST
URL	`https://api.trello.com/1/cards?idList=LIST_ID`
Cabeçalhos da solicitação	`Authorization`: `OAuth oauth_consumer_key="API_KEY", oauth_token="TOKEN"`
Parâmetros do corpo	`name` (string, obrigatório): “Título curto com o nome da pessoa que ligou e o que ela precisa, por exemplo: Retornar a ligação de Jane Doe sobre um orçamento.” `desc` (string, obrigatório): “O nome, o número de telefone e os detalhes da solicitação da pessoa que ligou.”
Atribuir a agentes	Recepcionista

Digite ?idList=LIST_ID no próprio campo de URL, com o ID da sua lista. Não adicione idList como um parâmetro de consulta: os parâmetros de consulta são preenchidos pela IA, enquanto o texto na URL é enviado exatamente como foi escrito.

O Trello também aceita a chave e o token na URL, como &key=API_KEY&token=TOKEN. Isso também funciona, mas o cabeçalho os mantém fora da URL. Se você colocá-los na URL, trate a URL inteira como um segredo.

Selecione Ativar e depois teste sua recepcionista pedindo um retorno. O cartão aparecerá no fim da lista.

Solução de problemas

Problema	O que verificar
O Trello retorna 401	Verifique o cabeçalho: a chave e o token devem estar entre aspas duplas, separados por uma vírgula e um espaço. Gere o token novamente se ele foi revogado.
`invalid value for idList`	O ID da lista na URL está errado. Use o `id` da lista, não o do quadro.
O Trello retorna 404 ou sem acesso	O usuário do token deve ser membro do quadro.
A recepcionista nunca cria cartões	Faça a descrição da ferramenta mencionar as situações em que ela deve criar um cartão.