Mobile Message
O Mobile Message é uma API de SMS australiana -- popular entre as igrejas australianas porque oferece números locais e preços competitivos na Austrália, enquanto a Clearstream e a Text In Church são voltadas aos EUA. O Mobile Message não tem, hoje, um app oficial no Zapier, mas publica uma API REST pública, então você pode conectar os eventos do B1 aos textos do Mobile Message pelo Webhooks by Zapier (ou pelo módulo HTTP do Make) em alguns minutos.
Antes de começar
- Uma conta no Mobile Message com um ID de remetente registrado e credenciais de API (nome de usuário e senha da API em Conta → Configurações de API)
- Uma conta no Zapier (ou no Make)
- Um usuário do B1Admin com a permissão Editar configurações
O que você pode conectar
A API do Mobile Message tem o formato de "enviar SMS" -- não há gatilhos, apenas texto de saída. Por isso, todas as receitas vão do B1 para o SMS:
| Direção | Gatilho do B1 | Resultado |
|---|---|---|
| B1 → Mobile Message | person.created | Mensagem de boas-vindas para a nova pessoa |
| B1 → Mobile Message | donation.created | Mensagem de agradecimento para o doador |
| B1 → Mobile Message | form.submission.created | Aciona a equipe de plantão |
| B1 → Mobile Message | event.created | Lembrete em massa para uma lista |
Configuração
1. Crie uma chave de API do B1
Configurações → Desenvolvedor → Chaves de API → Nova chave de API:
settings:write-- para que o webhook do gatilho seja registradopeople:read-- para buscar o número de telefone do destinatário a partir de umpersonId
2. Monte o Zap com o Webhooks by Zapier
- Gatilho -- B1.church: escolha o evento desejado (por exemplo, Nova doação).
- Ação -- B1.church: Encontrar pessoa (usando
data.personId) para obter o telefone e o nome. - Ação -- Webhooks by Zapier: POST. Configure conforme indicado abaixo.
As configurações da etapa POST:
- URL --
https://api.mobilemessage.com.au/v1/messages - Tipo de payload -- JSON
- Data --
{
"messages": [
{
"to": "{{step2_phone}}",
"message": "Thanks for your gift, {{step2_first_name}}!",
"sender": "YourChurch"
}
]
} - Headers --
Content-Type: application/json(o Webhooks by Zapier adiciona isso automaticamente) - Basic Auth -- preencha o campo Basic Auth com
<api_username>|<api_password>(o Zapier converte isso para o cabeçalhoAuthorization: Basic …correto)
Ative o Zap. Envie uma doação de teste no B1Admin para verificar se a mensagem chega.
Receitas comuns
Lembretes de eventos na manhã do evento
- Gatilho -- Agendamento pelo Zapier (diário, às 7h)
- Ação -- mantenha a lista de eventos do dia em uma planilha do Google (ou em outro app que o Zapier consiga ler) e busque as linhas do dia -- o app do B1 no Zapier não tem uma ação para buscar eventos
- Ação -- Webhooks by Zapier: POST no Mobile Message com a lista de eventos para um grupo de assinantes cadastrado
Use o endpoint em lote para um envio em massa para uma lista
O endpoint /v1/messages do Mobile Message aceita até 10.000 mensagens por chamada. Para enviar a um grupo do B1:
- Gatilho -- B1.church: Novo envio de formulário (filtrado para um formulário específico)
- Ação -- Webhooks by Zapier: GET em
/membership/groupmembers?groupId=…para listar os membros do grupo de destino (o app do B1 no Zapier não tem uma ação de listagem para isso; envie a chave de API como cabeçalhoAuthorization: Bearer cak_…) - Ação -- Formatter by Zapier → Utilities → Line-itemize para transformar a resposta em um array
messages - Ação -- Webhooks by Zapier: POST do array completo em
/v1/messages
Alternativa com o Make
Se preferir o Make, adicione o módulo HTTP -- Fazer uma requisição depois do gatilho Observar eventos do B1 e configure-o da mesma forma (POST, Basic Auth, corpo JSON). Veja a visão geral do Make para o lado do B1 -- observe que o aplicativo do B1.church para o Make ainda não foi lançado.
Limites e observações
- Basic Auth é o único método de autenticação -- o Mobile Message emite um nome de usuário e uma senha pelo painel. Trate os dois como segredos.
senderprecisa ser um ID de remetente registrado na sua conta do Mobile Message; caso contrário, o envio retorna400 Invalid sender. As regras australianas exigem o registro do remetente.- Números de telefone australianos podem ser
0412345678(local) ou+61412345678(internacional). A API aceita os dois, mas padronize em+61…se também enviar mensagens para o exterior. - Até 10.000 mensagens por requisição -- útil para envios em massa, mas uma única entrega de webhook do B1 raramente gerará uma lista tão grande; reserve o endpoint em lote para Zaps de envio em massa agendados.
Solução de problemas
- O POST retorna
401 Unauthorized-- as credenciais de Basic Auth estão erradas. Copie-as novamente do painel do Mobile Message em Conta → Configurações de API. Observe que, por padrão, o nome de usuário é o e-mail da sua conta, e não uma chave de API separada. - O POST retorna
400 Invalid sender-- o valor desendernão é um ID de remetente registrado na sua conta. Registre-o primeiro no painel do Mobile Message. - A mensagem chega cortada -- o Mobile Message divide mensagens com mais de aproximadamente 160 caracteres em várias partes, e a cobrança é feita por parte. Confira o corpo da resposta, que informa o número de partes.
Veja também
- Clearstream e Text In Church -- provedores alternativos de SMS com apps nativos no Zapier (sem a etapa Webhooks by Zapier)
- Zapier (visão geral) -- o lado do B1 de todas as receitas do Zapier
- Documentação da API do Mobile Message