Sincronizar contatos com o SendGrid
Made by Twilio
Mantém uma coleção de dados de contato do Firestore sincronizada com uma lista de contatos da campanha de marketing do SendGrid
Como esta extensão funciona
Use esta extensão para adicionar, atualizar ou remover contatos da sua lista de contatos do SendGrid Marketing Campaigns com base nas informações adicionadas a uma coleção especificada do Cloud Firestore.
Adicionar um documento aciona esta extensão para adicionar um contato à lista de contatos do Marketing Campaigns. A atualização de um documento atualiza os dados do contato e a exclusão do documento aciona a remoção dele da lista de contatos no SendGrid.
Veja um documento de exemplo que acionaria esta extensão:
admin.firestore().collection('contacts').add({ email: 'someone@example.com', first_name: 'Bob', last_name: 'Bobson' });
No documento, você pode adicionar qualquer um dos campos a seguir ao seu documento e eles serão aplicados ao seu contato:
Campo | tipo | |
---|---|---|
email |
string | obrigatório |
alternate_emails |
Matriz |
|
first_name |
string | |
last_name |
string | |
address_line_1 |
string | |
address_line_2 |
string | |
city |
string | |
postal_code |
string | |
state_province_region |
string | |
country |
string | |
phone_number |
string | |
whatsapp |
string | |
line |
string | |
facebook |
string | |
unique_name |
string | |
custom_fields |
Mapa |
custom_fields
precisam ser definidos na sua conta do SendGrid e são um mapa do ID dos campos personalizados para o conteúdo.
Outras configurações
Antes de instalar a extensão, verifique o seguinte:
- Você configurou um banco de dados do Cloud Firestore no seu projeto do Firebase
- Você se inscreveu para uma conta do Twilio SendGrid Marketing Campaigns
- Você criou uma chave da API SendGrid com acesso às APIs de marketing
Faturamento
Para instalar uma extensão, seu projeto precisa estar no plano Blaze, com pagamento por utilização
- Um pequeno valor será cobrado de você (geralmente cerca de US$ 0,01/mês) referente aos recursos do Firebase exigidos pela extensão, mesmo se não forem usados.
- Esta extensão usa outros serviços do Firebase e do Google Cloud Platform, que têm cobranças associadas caso o nível sem custos seja excedido:
- Cloud Firestore
- Cloud Functions (ambiente de execução Node.js 10+. Consulte as perguntas frequentes)
- Cloud Secret Manager
O uso desta extensão também exige que você tenha uma conta do Twilio SendGrid e credenciais para usar a API Twilio SendGrid para campanhas de marketing. Os custos associados ao uso desse serviço são responsabilidade sua.
Como instalar a extensão
Como usar o Console do Firebase
Para instalar e gerenciar extensões, use o Console do Firebase.
Instalar usando o consoleComo usar a Firebase CLI
Para instalar e gerenciar extensões, também é possível usar a Firebase CLI:
Etapa 1: execute o comando npm (em inglês) a seguir para instalar a CLI ou atualizá-la para a versão mais recente.
npm install -g firebase-toolsNão está funcionando? Consulte a referência da Firebase CLI ou altere suas permissões do npm (em inglês).
Etapa 2: configurar um novo diretório do projeto no Firebase ou acessar um já configurado
Etapa 3: adicionar esta extensão ao seu manifesto de extensões ao ser executada
firebase ext:install twilio/sendgrid-sync-contacts --local --project=projectId_or_alias
Etapa 4 (opcional): testar a extensão localmente usando o Pacote de emuladores do Firebase
firebase emulators:start
Etapa 5: implantar as extensões do seu manifesto ao projeto
firebase deploy --only extensions --project=projectId_or_alias