Conecta-seEntrar na plataforma

Twilio SMS

Enviar mensagens SMS por meio da Twilio.

Integrações e ferramentasComunicaçãoConexão: Credencial protegida

O que faz

Integre o Twilio ao fluxo. Permite enviar mensagens SMS.

Quando usar: Use quando o seu fluxo precisar enviar mensagens SMS por meio da Twilio.

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

Antes de começar

Conexão necessária: Credencial protegida.

Escolha uma conexão ou credencial já cadastrada no workspace. Nunca cole senhas ou chaves em campos de texto comuns.

Passo a passo

  1. Adicione Twilio SMS ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
  2. Escolha uma conexão ou credencial já cadastrada no workspace. Nunca cole senhas ou chaves em campos de texto comuns.
  3. Revise a ação principal descrita no cartão do bloco.
  4. Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
  5. Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
  6. Só publique depois de conferir o resultado da execução de teste.

Para configurar o gatilho

  1. Copie a URL do webhook acima.
  2. Informe acima o seu Account SID e o seu Auth Token, para que a plataforma possa verificar o X-Twilio-Signature em cada requisição.
  3. Acesse a página Phone Numbers do Twilio Console e selecione o número que vai receber as mensagens (ou abra Messaging Services, se você usa um).
  4. Na seção Messaging Configuration, defina "A MESSAGE COMES IN" como Webhook e cole a URL do webhook.
  5. Confira se o método HTTP está definido como POST.
  6. Salve as alterações no Twilio Console e depois clique em "Salvar" acima para ativar o gatilho.

Campos

Mostrar campos de

  • Telefones dos destinatários

    Obrigatório

    Informe os telefones com o código do país (um por linha, ex.: +5511987654321).

    Exemplo:
    +5511999999999

  • Mensagem

    Obrigatório

    Informa a mensagem que será enviada ou processada.

    Exemplo:
    Olá! Sua solicitação foi processada com sucesso.

  • Account SID do Twilio

    Obrigatório

    Informe o Account SID da sua conta do Twilio.

    Exemplo:
    id-do-recurso

  • Token de autenticação

    ObrigatórioDado protegido

    Informe o token de autenticação (Auth Token) do Twilio.

    Padrão:
    Segredo protegido

  • Número do Twilio que envia

    Obrigatório

    Define um valor numérico, quantidade ou limite da operação.

    Exemplo:
    cliente@exemplo.com

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 <twiliosms.success>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.

ReferênciaTipoO que contém
<twiliosms.success>booleanIndica se o envio foi concluído com sucesso.
<twiliosms.messageId>stringSID da mensagem no Twilio.
<twiliosms.status>stringStatus de entrega do SMS (queued, sent, delivered etc.).
<twiliosms.error>stringInformações do erro, se o envio falhar.

Exemplo de uso

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

InícioTwilio SMSpróxima etapa
Telefones dos destinatários
+5511999999999
Mensagem
Olá! Sua solicitação foi processada com sucesso.
Account SID do Twilio
id-do-recurso
Número do Twilio que envia
cliente@exemplo.com

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 <twiliosms.success>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
Credencial ausente ou recusada
Escolha uma conexão válida do workspace. Se a senha ou a chave mudou no serviço, atualize a conexão cadastrada em vez de colar o segredo no bloco.
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.

Blocos relacionados