Spotify

Pesquisar músicas, administrar playlists, controlar reprodução e acessar a biblioteca do Spotify.

Integrações e ferramentasComunicaçãoConexão: OAuth

O que faz

Integre o Spotify ao seu fluxo. Busque faixas, álbuns, artistas e playlists. Gerencie playlists, acesse a sua biblioteca, controle a reprodução e explore podcasts e audiolivros.

Quando usar: Use quando o seu fluxo precisar pesquisar músicas, administrar playlists, controlar reprodução e acessar a biblioteca do Spotify.

Exemplo de situação: Enviar uma confirmação ao cliente ou à equipe no canal correto.

Antes de começar

Conexão necessária: OAuth.

Conecte a conta pelo botão de autorização do campo de credencial e confira qual usuário ou organização foi escolhido.

Passo a passo

Adicione Spotify ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
Conecte a conta pelo botão de autorização do campo de credencial e confira qual usuário ou organização foi escolhido.
Escolha a operação. O painel mostra só os campos que essa operação usa.
Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
Só publique depois de conferir o resultado da execução de teste.

Operações

Operação	O que faz
Buscar	Busca com o bloco Spotify.
Obter faixa	Obtém faixa com o bloco Spotify.
Obter várias faixas	Obtém várias faixas com o bloco Spotify.
Obter álbum	Obtém álbum com o bloco Spotify.
Obter vários álbuns	Obtém vários álbuns com o bloco Spotify.
Obter faixas do álbum	Obtém faixas do álbum com o bloco Spotify.
Obter álbuns salvos	Obtém álbuns salvos com o bloco Spotify.
Salvar álbuns	Salva álbuns com o bloco Spotify.
Remover álbuns salvos	Remove álbuns salvos com o bloco Spotify.
Verificar álbuns salvos	Verifica álbuns salvos com o bloco Spotify.
Obter artista	Obtém artista com o bloco Spotify.
Obter vários artistas	Obtém vários artistas com o bloco Spotify.
Obter álbuns do artista	Obtém álbuns do artista com o bloco Spotify.
Obter faixas mais populares do artista	Obtém faixas mais populares do artista com o bloco Spotify.
Seguir artistas	Segue artistas com o bloco Spotify.
Deixar de seguir artistas	Deixa de seguir artistas com o bloco Spotify.
Obter artistas seguidos	Obtém artistas seguidos com o bloco Spotify.
Verificar se segue	Verifica se segue com o bloco Spotify.
Obter podcast	Obtém podcast com o bloco Spotify.
Obter vários podcasts	Obtém vários podcasts com o bloco Spotify.
Obter episódios do podcast	Obtém episódios do podcast com o bloco Spotify.
Obter podcasts salvos	Obtém podcasts salvos com o bloco Spotify.
Salvar podcasts	Salva podcasts com o bloco Spotify.
Remover podcasts salvos	Remove podcasts salvos com o bloco Spotify.
Verificar podcasts salvos	Verifica podcasts salvos com o bloco Spotify.
Obter episódio	Obtém episódio com o bloco Spotify.
Obter vários episódios	Obtém vários episódios com o bloco Spotify.
Obter episódios salvos	Obtém episódios salvos com o bloco Spotify.
Salvar episódios	Salva episódios com o bloco Spotify.
Remover episódios salvos	Remove episódios salvos com o bloco Spotify.
Verificar episódios salvos	Verifica episódios salvos com o bloco Spotify.
Obter audiolivro	Obtém audiolivro com o bloco Spotify.
Obter vários audiolivros	Obtém vários audiolivros com o bloco Spotify.
Obter capítulos do audiolivro	Obtém capítulos do audiolivro com o bloco Spotify.
Obter audiolivros salvos	Obtém audiolivros salvos com o bloco Spotify.
Salvar audiolivros	Salva audiolivros com o bloco Spotify.
Remover audiolivros salvos	Remove audiolivros salvos com o bloco Spotify.
Verificar audiolivros salvos	Verifica audiolivros salvos com o bloco Spotify.
Obter playlist	Obtém playlist com o bloco Spotify.
Obter faixas da playlist	Obtém faixas da playlist com o bloco Spotify.
Obter capa da playlist	Obtém capa da playlist com o bloco Spotify.
Obter minhas playlists	Obtém minhas playlists com o bloco Spotify.
Criar playlist	Cria playlist com o bloco Spotify.
Atualizar playlist	Atualiza playlist com o bloco Spotify.
Adicionar capa à playlist	Adiciona capa à playlist com o bloco Spotify.
Adicionar faixas à playlist	Adiciona faixas à playlist com o bloco Spotify.
Remover faixas da playlist	Remove faixas da playlist com o bloco Spotify.
Reordenar itens da playlist	Reordena itens da playlist com o bloco Spotify.
Substituir itens da playlist	Substitui itens da playlist com o bloco Spotify.
Seguir playlist	Segue playlist com o bloco Spotify.
Deixar de seguir playlist	Deixa de seguir playlist com o bloco Spotify.
Verificar seguidores da playlist	Verifica seguidores da playlist com o bloco Spotify.
Obter meu perfil	Obtém meu perfil com o bloco Spotify.
Obter perfil do usuário	Obtém perfil do usuário com o bloco Spotify.
Obter minhas faixas mais ouvidas	Obtém minhas faixas mais ouvidas com o bloco Spotify.
Obter meus artistas mais ouvidos	Obtém meus artistas mais ouvidos com o bloco Spotify.
Obter faixas salvas	Obtém faixas salvas com o bloco Spotify.
Salvar faixas	Salva faixas com o bloco Spotify.
Remover faixas salvas	Remove faixas salvas com o bloco Spotify.
Verificar faixas salvas	Verifica faixas salvas com o bloco Spotify.
Obter faixas tocadas recentemente	Obtém faixas tocadas recentemente com o bloco Spotify.
Obter novos lançamentos	Obtém novos lançamentos com o bloco Spotify.
Obter categorias	Obtém categorias com o bloco Spotify.
Obter mercados disponíveis	Obtém mercados disponíveis com o bloco Spotify.
Obter estado da reprodução	Obtém estado da reprodução com o bloco Spotify.
Obter o que está tocando	Obtém o que está tocando com o bloco Spotify.
Obter dispositivos	Obtém dispositivos com o bloco Spotify.
Obter fila	Obtém fila com o bloco Spotify.
Reproduzir	Reproduze com o bloco Spotify.
Pausar	Pausa com o bloco Spotify.
Pular para a próxima	Pula para a próxima com o bloco Spotify.
Voltar para a anterior	Volta para a anterior com o bloco Spotify.
Ir para a posição	Executa a operação “Ir para a posição” com o bloco Spotify.
Adicionar à fila	Adiciona à fila com o bloco Spotify.
Definir volume	Define volume com o bloco Spotify.
Definir repetição	Define repetição com o bloco Spotify.
Definir modo aleatório	Define modo aleatório com o bloco Spotify.
Transferir reprodução	Transfere reprodução com o bloco Spotify.

Campos

Mostrar campos de

Operação
Escolhe qual ação este bloco executará.
Opções:
Buscar · Obter faixa · Obter várias faixas · Obter álbum · Obter vários álbuns · Obter faixas do álbum · Obter álbuns salvos · Salvar álbuns · Remover álbuns salvos · Verificar álbuns salvos · Obter artista · Obter vários artistas · Obter álbuns do artista · Obter faixas mais populares do artista · Seguir artistas · Deixar de seguir artistas · Obter artistas seguidos · Verificar se segue · Obter podcast · Obter vários podcasts · Obter episódios do podcast · Obter podcasts salvos · Salvar podcasts · Remover podcasts salvos · Verificar podcasts salvos · Obter episódio · Obter vários episódios · Obter episódios salvos · Salvar episódios · Remover episódios salvos · Verificar episódios salvos · Obter audiolivro · Obter vários audiolivros · Obter capítulos do audiolivro · Obter audiolivros salvos · Salvar audiolivros · Remover audiolivros salvos · Verificar audiolivros salvos · Obter playlist · Obter faixas da playlist e mais 38
Padrão:
Buscar
Conta do Spotify
Obrigatório
Seleciona a conta já conectada que autoriza o acesso ao serviço.
Exemplo:
(escolha a conta conectada)
Conta do Spotify
ObrigatórioEm campos adicionais
Informa manualmente a credencial usada pela integração no modo avançado.
Consulta de busca
Obrigatório conforme a operação
Informa a consulta usada para localizar ou transformar dados.
Aparece em:
Buscar
Exemplo:
SELECT * FROM clientes WHERE status = 'ativo'
Tipo de busca
Escolhe uma das opções aceitas por este campo.
Aparece em:
Buscar
Opções:
Faixas · Álbuns · Artistas · Playlists · Podcasts · Episódios · Audiolivros · Todos
Padrão:
Faixas
ID da faixa
Obrigatório conforme a operação
ID da faixa no Spotify.
Aparece em:
Obter faixa
Exemplo:
id-do-recurso
IDs das faixas
Obrigatório conforme a operação
IDs das faixas, separados por vírgula.
Aparece em:
Obter várias faixas, Salvar faixas, Remover faixas salvas, Verificar faixas salvas
Exemplo:
IDs das faixas, separados por vírgula
ID do álbum
Obrigatório conforme a operação
ID do álbum no Spotify.
Aparece em:
Obter álbum, Obter faixas do álbum
Exemplo:
id-do-recurso
IDs dos álbuns
Obrigatório conforme a operação
IDs dos álbuns, separados por vírgula.
Aparece em:
Obter vários álbuns, Salvar álbuns, Remover álbuns salvos, Verificar álbuns salvos
Exemplo:
IDs dos álbuns, separados por vírgula
ID do artista
Obrigatório conforme a operação
ID do artista no Spotify.
Aparece em:
Obter artista, Obter álbuns do artista, Obter faixas mais populares do artista
Exemplo:
id-do-recurso
IDs dos artistas
Obrigatório conforme a operação
IDs dos artistas, separados por vírgula.
Aparece em:
Obter vários artistas, Seguir artistas, Deixar de seguir artistas
Exemplo:
IDs dos artistas, separados por vírgula
ID do podcast
Obrigatório conforme a operação
ID do podcast no Spotify.
Aparece em:
Obter podcast, Obter episódios do podcast
Exemplo:
id-do-recurso
IDs dos podcasts
Obrigatório conforme a operação
IDs dos podcasts, separados por vírgula.
Aparece em:
Obter vários podcasts, Salvar podcasts, Remover podcasts salvos, Verificar podcasts salvos
Exemplo:
IDs dos podcasts, separados por vírgula
ID do episódio
Obrigatório conforme a operação
ID do episódio no Spotify.
Aparece em:
Obter episódio
Exemplo:
id-do-recurso
IDs dos episódios
Obrigatório conforme a operação
IDs dos episódios, separados por vírgula.
Aparece em:
Obter vários episódios, Salvar episódios, Remover episódios salvos, Verificar episódios salvos
Exemplo:
IDs dos episódios, separados por vírgula
ID do audiolivro
Obrigatório conforme a operação
ID do audiolivro no Spotify.
Aparece em:
Obter audiolivro, Obter capítulos do audiolivro
Exemplo:
id-do-recurso
IDs dos audiolivros
Obrigatório conforme a operação
IDs dos audiolivros, separados por vírgula.
Aparece em:
Obter vários audiolivros, Salvar audiolivros, Remover audiolivros salvos, Verificar audiolivros salvos
Exemplo:
IDs dos audiolivros, separados por vírgula
Tipo
Escolhe uma das opções aceitas por este campo.
Aparece em:
Verificar se segue
Opções:
Artista · Usuário
Padrão:
Artista
IDs a verificar
Obrigatório conforme a operação
IDs de artistas ou usuários, separados por vírgula.
Aparece em:
Verificar se segue
Exemplo:
IDs de artistas ou usuários, separados por vírgula
ID do usuário
Obrigatório conforme a operação
ID do usuário no Spotify.
Aparece em:
Obter perfil do usuário
Exemplo:
id-do-recurso
ID da playlist
Obrigatório conforme a operação
ID da playlist no Spotify.
Aparece em:
Obter playlist, Obter faixas da playlist, Obter capa da playlist, Atualizar playlist, Adicionar capa à playlist, Adicionar faixas à playlist, Remover faixas da playlist, Reordenar itens da playlist, Substituir itens da playlist, Seguir playlist, Deixar de seguir playlist, Verificar seguidores da playlist
Exemplo:
id-do-recurso
Nome da playlist
Obrigatório conforme a operação
Minha playlist incrível.
Aparece em:
Criar playlist
Exemplo:
Exemplo de atendimento
Novo nome
Novo nome da playlist (opcional).
Aparece em:
Atualizar playlist
Exemplo:
Exemplo de atendimento
Descrição da playlist
Descrição da playlist (opcional).
Aparece em:
Criar playlist, Atualizar playlist
Exemplo:
Descrição da playlist (opcional)
Pública
Ativa ou desativa este comportamento.
Aparece em:
Criar playlist, Atualizar playlist, Seguir playlist
Padrão:
true
IDs dos usuários
Obrigatório conforme a operação
IDs dos usuários a verificar, separados por vírgula (máx. 5).
Aparece em:
Verificar seguidores da playlist
Exemplo:
IDs dos usuários a verificar, separados por vírgula (máx. 5)
Imagem de capa
Obrigatório conforme a operação
Envie a imagem de capa (JPEG, máx. 256 KB).
Aparece em:
Adicionar capa à playlist
Exemplo:
(selecione um arquivo de teste)
Imagem de capa
Obrigatório conforme a operaçãoEm campos adicionais
Referencie uma imagem de blocos anteriores.
Aparece em:
Adicionar capa à playlist
Início do intervalo
Obrigatório conforme a operação
Índice inicial dos itens a mover.
Aparece em:
Reordenar itens da playlist
Exemplo:
A1:D20
Inserir antes de
Obrigatório conforme a operação
Índice antes do qual inserir.
Aparece em:
Reordenar itens da playlist
Exemplo:
Índice antes do qual inserir
Tamanho do intervalo
Quantidade de itens a mover (padrão: 1).
Aparece em:
Reordenar itens da playlist
Exemplo:
A1:D20
URIs das faixas
Obrigatório conforme a operação
Faixas do Spotify em formato URI, separadas por vírgula: spotify:track: seguido do ID que aparece no link de compartilhamento da música.
Aparece em:
Adicionar faixas à playlist, Remover faixas da playlist, Substituir itens da playlist
Exemplo:
https://api.exemplo.com/v1/recurso
País
Código ISO do país (ex.: US, GB).
Aparece em:
Obter novos lançamentos, Obter categorias
Exemplo:
10
Período
Define a data, o horário ou a programação usada pela operação.
Aparece em:
Obter minhas faixas mais ouvidas, Obter meus artistas mais ouvidos
Opções:
Últimas 4 semanas · Últimos 6 meses · Todo o período
Padrão:
Últimos 6 meses
Exemplo:
Últimas 4 semanas
ID do dispositivo
Opcional — se ficar vazio, usa o dispositivo ativo.
Aparece em:
Reproduzir, Pausar, Pular para a próxima, Voltar para a anterior, Adicionar à fila, Definir volume, Ir para a posição, Definir repetição, Definir modo aleatório
Exemplo:
id-do-recurso
URI do contexto
Informa o endereço seguro do serviço ou recurso que será acessado.
Aparece em:
Reproduzir
Exemplo:
https://api.exemplo.com/v1/recurso
URIs das faixas
Faixas que o Spotify vai tocar, em formato URI e separadas por vírgula: spotify:track: seguido do ID que aparece no link de compartilhamento da música.
Aparece em:
Reproduzir
Exemplo:
https://api.exemplo.com/v1/recurso
URI da faixa
Obrigatório conforme a operação
Informa o endereço seguro do serviço ou recurso que será acessado.
Aparece em:
Adicionar à fila
Exemplo:
https://api.exemplo.com/v1/recurso
Volume
Volume da reprodução no dispositivo ativo do Spotify, de 0 (mudo) a 100 (máximo).
Aparece em:
Definir volume
Posição (ms)
Obrigatório conforme a operação
Posição em milissegundos.
Aparece em:
Ir para a posição
Exemplo:
Posição em milissegundos
Modo de repetição
Escolhe uma das opções aceitas por este campo.
Aparece em:
Definir repetição
Opções:
Desativado · Faixa · Contexto (álbum/playlist)
Padrão:
Desativado
Modo aleatório
Ativa ou desativa este comportamento.
Aparece em:
Definir modo aleatório
Padrão:
false
ID do dispositivo de destino
Obrigatório conforme a operação
ID do dispositivo para onde transferir.
Aparece em:
Transferir reprodução
Exemplo:
id-do-recurso
Limite
Número de resultados (1-50, padrão: 20).
Aparece em:
Buscar, Obter faixas do álbum, Obter álbuns salvos, Obter álbuns do artista, Obter faixas da playlist, Obter minhas playlists, Obter minhas faixas mais ouvidas, Obter meus artistas mais ouvidos, Obter faixas salvas, Obter faixas tocadas recentemente, Obter novos lançamentos, Obter categorias, Obter artistas seguidos, Obter episódios do podcast, Obter podcasts salvos, Obter episódios salvos, Obter capítulos do audiolivro, Obter audiolivros salvos
Exemplo:
10

Saídas

Para usar um resultado deste bloco em uma etapa seguinte, digite < no campo e escolha o bloco e o campo. A referência tem o formato <spotify.tracks>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.

Referência	Tipo	O que contém
`<spotify.tracks>`	json	Lista de faixas.
`<spotify.artists>`	json	Lista de artistas.
`<spotify.albums>`	json	Lista de álbuns.
`<spotify.playlists>`	json	Lista de playlists.
`<spotify.id>`	string	ID no Spotify.
`<spotify.name>`	string	Nome.
`<spotify.uri>`	string	URI do Spotify.
`<spotify.external_url>`	string	URL no Spotify.
`<spotify.image_url>`	string	URL da imagem de capa ou de perfil.
`<spotify.popularity>`	number	Índice de popularidade (0-100).
`<spotify.album>`	json	Informações do álbum.
`<spotify.duration_ms>`	number	Duração em milissegundos.
`<spotify.explicit>`	boolean	Tem conteúdo explícito.
`<spotify.preview_url>`	string	URL da prévia de 30 segundos.
`<spotify.album_type>`	string	Tipo do álbum (album = álbum, single = single, compilation = coletânea).
`<spotify.release_date>`	string	Data de lançamento.
`<spotify.label>`	string	Gravadora.
`<spotify.total_tracks>`	number	Total de faixas.
`<spotify.genres>`	json	Lista de gêneros.
`<spotify.followers>`	number	Número de seguidores.
`<spotify.description>`	string	Descrição.
`<spotify.owner>`	json	Informações do dono da playlist.
`<spotify.public>`	boolean	Indica se a playlist é pública.
`<spotify.collaborative>`	boolean	Indica se a playlist é colaborativa.
`<spotify.snapshot_id>`	string	ID do snapshot da versão da playlist.
`<spotify.publisher>`	string	Nome da editora.
`<spotify.total_episodes>`	number	Total de episódios do podcast.
`<spotify.shows>`	json	Lista de podcasts.
`<spotify.languages>`	json	Lista de idiomas.
`<spotify.show>`	json	Informações do podcast ao qual o episódio pertence.
`<spotify.episodes>`	json	Lista de episódios.
`<spotify.authors>`	json	Lista de autores.
`<spotify.narrators>`	json	Lista de narradores.
`<spotify.total_chapters>`	number	Total de capítulos.
`<spotify.audiobooks>`	json	Lista de audiolivros.
`<spotify.chapters>`	json	Lista de capítulos.
`<spotify.display_name>`	string	Nome de exibição do usuário.
`<spotify.email>`	string	E-mail do usuário.
`<spotify.country>`	string	Código do país do usuário.
`<spotify.product>`	string	Plano da assinatura (free = gratuito, premium = Premium).
`<spotify.is_playing>`	boolean	Indica se a reprodução está ativa.
`<spotify.device>`	json	Informações do dispositivo ativo.
`<spotify.devices>`	json	Dispositivos de reprodução disponíveis.
`<spotify.progress_ms>`	number	Posição atual da reprodução, em ms.
`<spotify.currently_playing_type>`	string	Tipo de conteúdo (track = faixa, episode = episódio, ad = anúncio).
`<spotify.shuffle_state>`	boolean	Indica se o modo aleatório está ativado.
`<spotify.repeat_state>`	string	Modo de repetição (off = desligado, track = faixa, context = contexto).
`<spotify.track>`	json	Faixa que está tocando agora.
`<spotify.currently_playing>`	json	Item que está tocando agora.
`<spotify.queue>`	json	Próximas faixas da fila.
`<spotify.items>`	json	Lista de itens tocados recentemente.
`<spotify.categories>`	json	Lista de categorias para explorar.
`<spotify.markets>`	json	Lista de códigos dos mercados disponíveis.
`<spotify.results>`	json	Resultados da verificação (id e o booleano saved).
`<spotify.all_saved>`	boolean	Indica se todas as faixas estão salvas.
`<spotify.none_saved>`	boolean	Indica se nenhuma faixa está salva.
`<spotify.total>`	number	Número total de itens.
`<spotify.next>`	string	URL da próxima página de resultados.
`<spotify.success>`	boolean	Indica se a operação foi concluída com sucesso.

Exemplo de uso

Objetivo: Enviar uma confirmação ao cliente ou à equipe no canal correto.

InícioSpotifypróxima etapa

Operação: Buscar
Conta do Spotify: (escolha a conta conectada)
Consulta de busca: SELECT * FROM clientes WHERE status = 'ativo'
Tipo de busca: Faixas
Limite: 10

Os valores são ilustrativos. Teste primeiro com dados fictícios ou de homologação.

Erros comuns e como resolver

O bloco não executa: Confira se existe um caminho de setas que parte do gatilho (ou do Início) até este bloco. Blocos soltos no desenho são ignorados.
Aparece “Validação do fluxo” no terminal: Há campo obrigatório vazio. Clique no aviso, abra o bloco indicado e preencha o campo marcado.
Um campo chega vazio na etapa seguinte: Confira se a referência aponta para um bloco que já executou e para um campo que existe, como <spotify.tracks>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
O campo que eu procuro não aparece: Os campos mudam conforme a operação escolhida. Escolha a operação primeiro; campos menos usados ficam em “Mostrar campos adicionais”.
Erro de autorização ou permissão (401/403): A conta conectada perdeu o acesso ou não tem permissão para esta operação. Reconecte a conta no campo de credencial e confirme as permissões pedidas.
O serviço recusou a chamada ou devolveu erro: Leia a mensagem no terminal: ela traz o motivo informado pelo serviço. Confira IDs, limites de uso e permissões, e teste antes com um recurso de homologação.

O que faz

Antes de começar

Passo a passo

Operações

Campos

Operação

Conta do Spotify

Conta do Spotify

Consulta de busca

Tipo de busca

ID da faixa

IDs das faixas

ID do álbum

IDs dos álbuns

ID do artista

IDs dos artistas

ID do podcast

IDs dos podcasts

ID do episódio

IDs dos episódios

ID do audiolivro

IDs dos audiolivros

Tipo

IDs a verificar

ID do usuário

ID da playlist

Nome da playlist

Novo nome

Descrição da playlist

Pública

IDs dos usuários

Imagem de capa

Imagem de capa

Início do intervalo

Inserir antes de

Tamanho do intervalo

URIs das faixas

País

Período

ID do dispositivo

URI do contexto

URIs das faixas

URI da faixa

Volume

Posição (ms)

Modo de repetição

Modo aleatório

ID do dispositivo de destino

Limite

Saídas

Exemplo de uso

Erros comuns e como resolver

Blocos relacionados